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Preface 


This System Installation Configuration and Updating Guide is intended for data 
processing personnel responsible for installing and updating the latest release of 
GCOS 7-TA/V9 or GCOS 7-XTA/V10 on: 


DPS 7000/TAxxx/TAxxxC 
DPS 7000/MTxx 

DPS 7000/8xx/Dx0/Mx0 
DPS 7000/4x5/Cx0 

DPS 7000/XTAxxx 


TA stands for GCOS 7 Twin Architecture and XTA for GCOS 7 eXtended Twin 
Architecture. Depending on the model and the customer order, some systems are 
delivered with the GCOS 7 Release already installed. Other DPS 7000s are 
delivered with an image of the GCOS 7 P-Set on tape or cartridge which is restored 
by Bull personnel. 


All the utilities necessary for Installation and Updating are provided within a single 
product named the Installation and Updating Facility (TUF). 


Chapter | Introduction 


Gives an overview of the IUF product. (Definitions of 
basic terms used in this manual can be found in the 
Glossary). 


Chapter 2 Installation Procedure 


Gives examples of the procedures performed by Bull 
personnel for loading and updating the operating 
system. 


Chapter 3 Multi-System Installation and Updating 


Describes how to install and maintain several system 
disks for multiple systems with the same or different 
configurations. 
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Chapter 4 


Chapter 5 


Chapter 6 


Chapter 7 


Chapter 8 


Chapter 9 


Chapter 10 


Chapter 11 


Chapter 12 


Appendix A 


Installation and Updating Facility 

Details the GIUF command which groups together the 
IUF functions and jobs used to install and maintain the 
operating system. 


CONFIG (Configuration) 
Describes the CONFIG job, for personalization of your 
system software configuration. 


TAILOR 

Describes the TAILOR utility, which enables the user 
to personalize his system files (produced as a result of 
the functions described in the main body of this 
manual), to suit the requirements of his own 
applications. 


Updating Domains 

Describes the procedures which enable you to perform 
preventative maintenance on the five system file 
Domains. 


Patching Procedures 

Describes the procedures which enable you to perform 
corrective maintenance on the two applicable system 
file Domains (GCOS and DSA). 


Firmware Generation (FGF) and Test and Diagnostics 
(OLTD) Facilities 

Describes the additional functions used by Bull 
personnel specific to installation and maintenance of 
the firmware Domain and the On-Line Test & 
Diagnostics Domain. 


DSA Installation and Updating Facility 
Details the DIUF facility specific to installation and 
maintenance of the frontend processor Domain. 


GCOS 7 Service Facilities (GSF) 

Details the additional functions specific to the 
installation and maintenance of the GCOS 7 Service 
Facilities Domain. 


Maintenance and Recovery Procedures 
Discusses the considerations of system installation and 
maintenance particular to the fixed-disk configuration. 


System File Descriptions 
Describes the system files together with their Data 
Management attributes. 
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Preface 


Appendix B SIP Functions 
Describes loading and use of the backup operating 
system, SIP together with the associated utility UTIL. 


Appendix C Disk VOLPREP Procedure 
Describes how to prepare a disk, and explains the 
allocation of alternate tracks for bad tracks. 


Appendix D Maintenance in a Protected Environment 
Describes the manipulation of the files used in 
maintaining GCOS 7, when using access rights. 


The following manuals are essential for operating the IUF functions: 


Error Messages and Return Codes Message DirectOry.....ccccccccceeseiees 47 A2 10US 
GCOS 7 System Administrator's Guide .......ccccccccccceceesscetseesseeeseenssenstenaes 47 A2 54US 
GCOS 7 System Operator's Guide......cccccccccccccccccccccesesesetseesscenssensseneenaes 47 A2 53US 
GCOS 7 Console Messages DireCtOry....ccccccccccccccccccecietitetiteentesneenseess 47 A2 61UU 


The reader should also be familiar with the following manuals: 


GCOS 7 System Overview ...ccccccccccccccceeneceeeecececeecseeseseeeeneeecsaeeeesseeneneeees 47 A2 22UG 
GCOS 7 Catalog Management User's Guide ......ccccccccccccccceeteeeeetsetteeeaes 47 A2 35UF 
DPS 7000/4xx/CxO Operator's Guide....ccccccccccccccccceceteceeecteecteenteenteenteens 77 Al 91UU 
DPS 7000/5x0/7xx Operator's Guide .....cccccccccccceccecetecetetetseeneeenstenetenes 77 Al 81UU 
DPS 7000/8xx/Dx0/Mx0 Operator's Guide .....ccccccccccctetettteetseeeeettenes 77 Al 94UU 
V7000 Operator 8s Guide.....cccccccccccccccccececeescecetecesecuseeeaecesecenseeeseenstenseenaes 47 A2 74US 
MainWay 2600LE User's Guide ....cccccccccccccccectccctcceecneeceecseeseenesneenaeens 39A2 60AE 
MainWay 2600LE Installation and Maintenance .........cccccccceieeteeteniees 39 A2 61AE 


The following manuals describe complementary generation functions that are 
implemented after installation: 


DNS-V4 System Generationi....ccccccccccccccccceccsecccececceceeseeseneeeccaeeessseseeneessas 39 A2 22DN 
DNS-V4 NGL Reference MAnudl .......ccccccccccccecscetcesstetseete ete es seta seeneenees 39 A2 23DN 
CNS 7A2-NGL Reference MAnudl .0....ccccccccccccccceseeecsteseseteeenseeneeenssenseenaes 39 A2 32DN 
CNS 7A2-NOI Operator's Guide ....ccccccccccccccececetccetsceceteceeeeseenssenssenseenaes 39 A2 34DN 
DNS-E NGL Reference Manu ....ccccccccccccccccecceeteets tess eens tees tenets seeaeensees 39 A2 10EB 
DNS-E NOT Operator Manudl...c.ccccccccccccceccceesceeeeee cette eet c eects ca seeaeenees 39 A2 86RA 
OSF/SNA NGL Reference Manual ......cccccccccccccccceceeetseeteteteeesseeneeenssenseenaes 39 A2 14RA 
MainWay DNS-E V1 System Generation Guide .......cccccccccccsceesetteeeteenees 39 A2 74RA 
MainWay DNS-E V3 System Generation Guide .......ccccccccccsceseteteesteenees 39 A2 09EB 
GCOS 7 Networks: Overview ...cccccccccccscccseccesceecesceensesuseeeeeeseeenseenseenaes 47 A2 92UC 
GCOS 7 Network Generation ....ccccccccccccccsscccsecssecetcceeueseeeeeeenesenssenseenaes 47 A2 93UC 
GCOS 7 Network User's Guide ...ccccccccccccccccecccetetecsceeneeuseeesseeneeenssenseenaes 47 A2 94UC 

Vv 
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Syntax 
Notation 


vi 


The following manuals are referred to in this document: 


Administering the Storage MAN ger ...cc.cccccccccccccecseetssetstetscenseesstenetenstenaes 47 A2 36UF 
File Migration Tool User's Guide..cc.ccccccccccscccscccescessseeseeeeceeceecsessessaes 47 A2 32UF 
File Recovery Facilities User's Guide ....cccccccccccccccecseeseeesenecnetsetnseesees 47 A2 37UF 
Full Screen Editor User's Guidé..ccccccccccccccccccccccsssccsessesecessssescsssseecenessees 47 A2 06UP 
MPT User and Administrator's Guide .......cccccccccccccccccssscesesssscessseesseesseees 47 A2 38UF 
Mirror Disks User's Guide ..cccccccccccccccccccccccscsccceesseeecessseescesssetecsssssesenssaees 47 A2 20UF 
TEX E diULOr OS CP'S GUtd Es vevcrcecgeustdeiseuns decteetecucestud eeeeuetuncatadleedea seteedeeetwees 47 A2 05UP 


The following conventions are used for presenting command syntax. 


ITEM 
An item in upper case is a literal value, to be specified as shown. The upper 
case is merely a convention; in practice you can specify the item in upper or 
lower case. 


Item 
An item in lower case is non-literal, indicating that a user-supplied value is 
expected. 


In most cases it gives the type and maximum length of the value: 


char105 _ astring of up to 105 alphanumeric characters 
dec5 a decimal integer value of up to 5 digits 
name31 a name of up to 31 characters 

file78 a file name of up to 78 characters 


In some cases, it gives the format of the value: 


a a single alphabetic character 
nnnn a 4-digit number 
hh.mm a time in hours and minutes 


In other cases, it is simply descriptive of the value: 
media:devclass 


ITEM 
An underlined item is a default value. 


Bool 
A boolean value which is either 1 or 0. A boolean parameter can be specified by 
its keyword alone, optionally prefixed by "N". Specifying the keyword alone 
always sets the value to 1. Prefixing the keyword with "N" always sets it to 0. 


oi 


Braces indicate a choice of values. Only one may be selected. 
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[] 


Square brackets indicate that the enclosed item is optional. An item not 
enclosed in square brackets is mandatory. 


() 


Parentheses indicate that a single value or a list of values can be specified. A 
list of values must be enclosed by parentheses, with each value separated by a 
comma or a space. 


Ellipses indicate that the item concerned can be specified more than once. 


+=$* - 
These are literal characters to be specified as shown. 


EXAMPLE 1: 

{ } 
{ { IMMED } 3 
{ WHEN={ [dd.mm.yy.]hh.mm } } 
{ { +nnnn{W|D|H|M} } } 
{ } 


This means you can specify: 


Nothing at all (WHEN=IMMED applies). 
WHEN=IMMED (the same as nothing at all). 
WHEN=22.30 to specify a time (and today's date). 
WHEN=10.11.87.22.30 to specify a date and time. 
WHEN=+0002W to specify 2 weeks from now. 
WHEN=+0021D to specify 21 days from now. 
WHEN=+005H to specify 5 hours from now. 
WHEN=+0123M to specify 123 minutes from now. 


OU 


EXAMPLE 2: 
[ PAGES=(dec4[-dec4] ...) ] 


An optional parameter giving either a single value or a list of values enclosed in 
parentheses, with each value separated by a comma or space. Each value can 
consist of either a single number or a pair of numbers connected by a hyphen. For 
example: 


PAGES= (2, 4,10-25,33-36,78 83 90) 


Q 
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EXAMPLE 3: 
[ REPLACE ={ bool | 0 } ] 
A boolean parameter whose default value is zero. You can specify: 


e Nothing at all (REPLACE=0 applies) 
e REPLACE=0 or simply NREPLACE 
e REPLACE=!1 or simply REPLACE 


Q) 


Tape, Cartridge, and Cassette Devices 


Where a tape, cartridge, or cassette device has to be specified, this is shown in the 
syntax as <tape-dvc>. 


This must be replaced by the appropriate full specification, as follows: 


Standard tape drive MT (MT/D1600 orMT/6250 
for VOLPREP only) 
Streamer tape drive MT/S (MT/D1600 orMT/6250 
for VOLPREP only) 
18-track 1/2" cartridge CT/M5 (with or without Sequential Cartridge 
Loader) 
CT/LIB/M5 (if ina library) 
36-track 1/2" cartridge CT/36T (with or without Sequential Cartridge 
Loader) 
CT/LIB/36T (if ina library) 
8mm cassette CT/M6 (CT/M6/S35 or CT/M6/S75 
for VOLPREP) 
NoTES: 


1. Streamer mode for tape drives can be used only with 
VOLSAVE/VOLREST and FILSAVE/FILREST. 


2. For cartridge drives, the attribute /C must be added for use of hardware 
compaction (if supported by the hardware). 


3. | When there is no possible ambiguity on a given site, that is where only one 
type of device is present, the device specification can be abbreviated, 
e.g. CT. 
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1. Introduction 


1.1 Overview 
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This manual describes the operations concerning GCOS 7 that may need to be 
carried out during the life cycle of DPS 7000/XTAxxx and the following DPS 7000 
models: 

e DPS 7000/TAxxx/TAxxxC 

e DPS 7000/MTxx 

e DPS 7000/8xx/Dx0/Mx0 

e DPS 7000/4x5/Cx0 


The installation procedure is specific to GCOS 7-TA/V9, to the systems listed 
above and to GCOS 7-XTA/V10. TA stands for the GCOS 7 Twin Architecture. 
XTA stands for the GCOS 7 eXtended Twin Architecture. 


Users of DPS 7000/5x0/7xx and DPS 7000/4x0 should refer to the manual 
47 A2 18US. 


Users of DPS 7000/XTAxxx should refer to the manuals 47 A2 53US (GCOS 7 
System Operator’s Guide) and 47 A2 74US (V7000 Operator’s Guide) 


The operations described include: 
e installation and migration from an earlier release (Installation and Updating 
Facility - TUF) 


e creation of new system disk set configurations for the security of system files 
(UF) 


e customization of system disk sets (TAILOR) 

e updating (UPDATE GCOS) 

e patching (Emergency Corrections and PATCH) 
e configuration (CONFIG) 

e security (SAVE and RESTORE) 
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Depending on the model and the customer order, either systems are delivered with 
the GCOS 7 Release already installed or are delivered with an image of the 
GCOS 7 P-Set on tape, cartridge, or cassette, which is restored by the Bull 
Customer Service Engineer (CSE). 


The delivered system disk configuration is referred to as a PO configuration. For 
security reasons, you are strongly advised to use one of the other configurations 
described below. 


NOTE: 


Information about DPS 7000/XTA models: 


1. 


All references to VBO disks are irrelevant because these disks are no 
longer supported on these models. 


For reasons of compatibility, the OLTD domain and its associated files 
still exist. However, their size has been reduced and there are no OLTD 
tests available on these models. 


Annex B “SIP FUNCTIONS’ has no relevance for these models. 


Seven firmware files have been deleted: SYS.FW.MSP, SYS.FW.WSP, 
SYS.FW.CCULIB, SYS.FW.NFTLIB, SYS.FW.PATCH, SYS.HUB and 
SYS.HUB7. The remaining ones are optimised in size. 


All of the references to the CDP (Customer Dedicated Processor) are 
irrelevant. 


The devclass “MT” no longer exists on these models. 


1(2)3 IMPORTANT: 
The use of mirror disks does not provide the required level of security for 


system disks. 
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1.1.1 System Disk Configurations 


There are three configuration possibilities for system disks: 
PO Configuration 


In a PO configuration, the P-Set only is used. The P-Set may consist of one or 
several disks. This is the least expensive but also the least secure configuration. 


P2P Configuration 


This is the recommended configuration. A P2P configuration consists of two 
identical Production Sets in the form of a P-Set and a P2-Set. These Production 
Sets, which may each consist of several disks, work in alternate mode. 


RP Configuration 


An RP Configuration consists of a Production Set (P-Set) and a Reference Set 
(R-Set). The R-Set contains all the files necessary for IUF operation and can be 
used to create a P-Set by means of the BUILDP function (see the chapter 
Installation and Updating Facility). 


1.1.2 System Disks and Resident Disks 


A disk containing system files is referred to as a SYSTEM disk. Such disks must 
be FSA (Fixed Sector Architecture) in all cases. 


Resident disks must generally be FBO (Fixed Block Organization). 


However, on certain DPS 7000 models, as listed below, VBO (Variable Block 
Organization) is supported but FBO is to be preferred wherever possible: 


DPS 7000/TAxxx/TAxxxC 
DPS 7000/8xx/Dx0/Mx0 
DPS 7000/MT42/52/62 and up 


A disk which is declared RESIDENT must be permanently on line. 
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1.2 Operating System Maintenance - IUF 


The Installation and Updating Facility (IUF) provides a set of functions and jobs to 
help install and maintain the GCOS 7 operating system. The facility is called by 
the GCL command GIUF. For full details, see the chapter /nstallation and 
Updating Facility. 


1.2.1 Features of IUF 


1. IUF supports multi-device classes in the following combinations: 
— between volumes of a given disk Set 
(except for DPS 7000/4x5/Cx0/MTx1) 


— between disk Sets of a given system 
(except for DPS 7000/4x5/Cx0/MTx1) 


— between disk Sets of several systems in a multi-system environment. 


GCOS 7 supports coexistence of FBO file organization and VBO file 
organization. However, system files (that contain all the GCOS Domains) 
must be located on FSA volumes. 


2. JUF functions support multiple-MI software configurations in a multi-system 
environment. 


3. IUF takes advantage of the GCL (GCOS 7 Command Language), the default 
language for the MAIN operator. The commands described in this document 
use GCL syntax. 


4. IUF supports cartridges and tapes. The device classes are, respectively, CT 
and MT. 


Throughout this document cartridges are included in all references to tapes. 
The term tape (cartridge) means: magnetic tape with the device class MT, or 
cartridge with the device class CT. 

— DPS 7000/4x5/Cx0/MTx1 support 8mm cartridges (CT/M6). 


— Other models support 8mm cassettes (CT/M6), half-inch cartridges 
(CT/MS or CT/36T), or tapes (MT/T9), according to the order. 


In certain cases, these systems can support emulated DLT cassette systems as 
8mm cassettes (CT/M6). 


See the Preface for a full list of tape, cartridge, and cassette specifications. 


1-4 47 A2 23US 


Introduction 


1.2.2 IUF Functions 


Table 1-1 lists the functions available in IUF. 


Table 1-1. IUF Functions for the GCOS Domain 


Procedures Installation Updating Patching 
Major VALIDP UPDATE_GCOS | PATCH _HLMLIB 
IUF VALIDP2 LEVEL PATCH SYSTEM 
Functions BUILDP2 
ADAPT COPY_SITEFILES 
ADD_MI DELETE_MI 
BUILDP DETECT_SITE 
BUILD_BKST DISPLAY_STATUS 
BUILD_CLC EDIT 
BUILD_CMS FSE 
Sikes BUILD_ HALOCK LEVEL_MI 
IUE BUILD_JAS LIST_MI 
Functions BUILD_JRNAL MODIFY_CONF 
BUILD_LIB PROTECT_GCOS 
BUILD_MIRLOG RESTORE_SITE 
BUILD_PVMF RESTORE_SITEFILES 
BUILD_QM SAVE_SET 
BUILD_QM_BACKUP RESTORE_SET 
BUILD_SPDUMP SAVE_SITE 
BUILD_SPOOL SAVE_SITEFILES 
BUILD_SYSDUMP UPDATE_MI 
BUILD_TVMF VALIDR 
IUF Function |DISPLAY RUNSET This function does not belong to the GIUF processor but 
in H NOCTX ~ is nevertheless documented with the other GCL commands 
i in the chapter /nstallation and Updating Facility 


1.2.3 IUF Jobs 


The following IUF jobs are fully described in the chapter Jnstallation and Updating 
Facility: 


INSTAL_ALL 
INSTAL_GCOS 
INSTAL_PSET 
INSTAL_RSET 
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1.2.4 GCOS 7 Domains 


IUF acts on GCOS 7 in terms of its components, which are known as Domains. 
The Domains are: 


GCOS General Comprehensive Operating System 

FW Firmware, also called BSR (Basic System Release) 
OLTD On Line Test and Diagnostics 

DSA Distributed Systems Architecture, for the support of 


the GCOS 7 telecommunications facilities. This 
includes CNS7 software for CNP7 front-end 
processors, DNS for Datanets, and/or OCS (FCP7 
software). 


GSF GCOS 7 Service Facility 
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2. Installation Procedure 


Installation is carried out in all circumstances by the Bull Customer Service 
Engineer (CSE). This chapter gives an example of the installation procedure for a 
new system with pre-loaded disk followed by an example of the update of a system 
running under an earlier version of GCOS 7. These descriptions are to be taken 
only as examples. Each DPS 7000 model and each configuration has its own 
particularities which is why the task is now carried out by the CSE. 


2.1 Before Beginning 


Before beginning the installation procedure: 


Make sure that you have the minimum hardware as described in Hardware and 
Firmware Requirements below. 


Make sure that you have all the installation media summarized in Table 2-1 
below. 


Decide on the number of FSA disks to be formatted as future system Set(s). See 
Hardware and Firmware Requirements below for the minimum requirements. A 
minimum P-Set built with one each of SYS.SPOOL(0), SYS.BKST(0), 
SYS.PVMF(0), SYS.TVMF(0), and SYS.LIB(0) requires about 0.8 to 1 Gbyte, 
depending on the number and type of the disks used. 


Make sure that enough disks are free for P-Set installation (see Hardware and 
Firmware Requirements below). 


Check that there is a minimum of 64 Mbytes of memory available. 


Check that there is a tape or cartridge drive connected that supports system 
functions. This is for restoring installation media, and for bootloading the 
system. 


Refer to the chapter Recovery Procedure. 


New users requiring a P2P-Configuration must prepare the TAILOR parameters for 
use in the BUILDP2 function which creates the P2-Set. 
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2.1.1 Hardware and Firmware Requirements 


2.1.1.1. On DPS 7000/4x5/Cx0/MTx1 Systems 
e The installed Basic System Release (BSR) must be at least the appropriate N1 
release (P2 for MTx1). 
e System files are supported only on: 


— integrated MS/FSA disks located in the central cabinet. At least 1.4 Gbyte or 
2.5 Gbyte disk is necessary to build the P-Set, 


— external RAID1 or RAIDS MS/FSA disks (other than those located in a Large 
Storage Subsystem (LSS)). Only one disk is necessary to build the P-Set. 


e An 8mm cassette drive is required for reading the shipped media and for the 
bootload function (CT/M6). 


2.1.1.2 On DPS 7000/TAxxx/TAxxxC/8xx/Dx0/Mx0, and DPS 7000/MTx2 Systems and up 
e The installed Basic System Release (BSR) must be at least the appropriate P2 
release. 
e System files are supported only on: 
— a Large Storage Subsystem (LSS), 


— external RAID1 or RAIDS MS/FSA disks (other than those located in an 
LSS). Only one disk is necessary to build the P-Set. 


e Any of the following: half-inch tape drive (MT/T9), half-inch cartridge drive 
(CT/MS, CT/LIB/MS5, CT/36T, or CT/LIB/36T), or 8mm cassette (CT/M6), is 
capable of reading the shipped media and the bootload function. 
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2.1.2 Installation Media Required 


Table 2-1 gives a checklist of the necessary installation media for the two cases 
discussed in this chapter. For other installation circumstances, check with your 
Bull CSE. 


Table 2-1. Checklist for Installation Media 


New Users Update Users 
with P-Set pre-loaded with GCOS 7 minimum 
disk(s) V7 TS 7356 


Installation 
Media 


SHIP-MEDIA 


YES (backup) 
MEDIA 
YES (mandatory) 


P-MEDIA YES (backup) 
P-SET YES (previous) 
G-MEDIA 


Migration from GCOS 7—V7 TS 7356 (and higher TSs) or from GCOS 7—V8 any 
Technical Statuses to GCOS 7—V9 needs to install a new complete validation key 
provided with the GCOS 7—V9 product kit. (G-MEDIA + K-MEDIA). 


Migration from GCOS 7—V7 TS 7356 (and higher TSs) or from GCOS 7-V8 or 
from GCOS 7-V9 any Technical Statuses to GCOS 7—V10 needs to install a new 
complete validation key provided with the GCOS 7—V10 product kit. (G-MEDIA 
+ K-MEDIA). 
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2.1.3 Initial Profiles 


When you start a session at the system console by introducing a break, a message is 
displayed asking for the user name and password. The SITE.CATALOG that has 
been delivered is validated, and contains the information given in Table 2-2. 


Table 2-2. Information Contained in the SITE.CATALOG 


PROJECT USER PASSWORD| PARAMETERS BILLING 
SYSADMIN SYSADMIN SYS NDFLT - |OF - 
SYSADMIN GCOS7 G7 DFLT - |OF - 
OPERATOR | OPERATOR | OP MAIN-DFLT-IOF | - 

RMS RMS empty MAIN - DFLT - |OF INSTALL 
RMSIOF RMSIOF empty DFLT - lOF INSTALL 


The initial profile of each operator logging onto the system is: 


GCLMODE=GCL 
OPERATING MODE=CONS 
GCLFORM=LINE 
NOVICE=1 

MENU=1 


NOTE: 
GCL mode is the default for all logons. To switch to JCL mode, enter: 
S: MDP GCLMODE=JCL; 
To return to GCL mode, enter: 
S: GCL; 
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2.2.2 
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P-MEDIA Restoration Procedure 


If the P-Set cannot be used for some reason, this procedure should be performed by 
the Bull CSE only as a backup. The delivered P-MEDIA is a VOLSAVE of your 
P-Set. 


Systems not XTA 
1. Initialize the system and load SIP from the hard disk. Refer to the appendix 
SIP and UTIL Mode for information on SIP. 


2. Make a first work disk available. This disk must belong to the same disk 
family as the delivered P-MEDIA. 


3. For each disk, use the RESTORE function of SIP in UTIL mode in order to 
restore the saved P-Set: 


R MSxx 


XTA Systems 


1. Initialize the system and load GCOS system from the bootstrap disk (B-DISK). 


2. For each disk use the RESTORE utility of GCOS in order to restore the saved 
P-Set.. 


Installation on a New DPS 7000 With Pre-loaded Disk 


The IUF installation procedure is used by the Bull CSE to build a GCOS 7 
operating system from the Production Set (P-Set). The P-Set contains all the 
system files, including the Domains files. Figure 2-1 shows an overview of the 
installation. 


47 A2 23US 2-5 


GCOS 7 System Installation Configuration and Updating Guide 


PO-CONFIGURATION 
G-MEDIA P2P-CONFIGURATION 
eee (P2-SET 
>> af 
DOMAINS- —_ 
MEDIA 
RP- 7 
so? CONFIGURATION a 
FW-MEDIA ; : / 
\ / R-SET | | 
is SET-MEDIA 
SET-MEDIA 
P-MEDIA 


K-MEDIA 


Figure 2-1. Installation Overview 


You are mandatorily supplied with a K-MEDIA for validation of software 
Marketing Identifiers (MIs). 
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K-MEDIA 


Factory-prepared P-Set 
| 
FIRMWARE 
GENERATION < 
(or Adaptation) 


User P-Set 


Figure 2-2. Installation: New Systems with Pre-loaded Disks 


Systems With Securized Disks 


On systems with securized disk subsystems, the sequence is: 


1. 


is) 


SO 


UTIL (not available on XTA systems) 
RESTORE 
INIT 


RESTORE (/) ,RESTART (CLEAN) , PVMF(/),TVMF(/),BKST(/), 
LIB(/) ,RESIDENT (/) 


FGF BUILDP2 
TSYS + TERMINATE SYSTEM 
INIT (new disk) 


RESTORE (/) ,RESTART (CLEAN) , PVMF(/),TVMF(/),BKST(/), 
LIB(/) ,RESIDENT (/) 


Follow this with the steps 3 through 10 of the case "Standard Disks" below. 
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Systems With Standard Disks 


On systems with standard disks, the sequence 1s: 


1. 
2. 


12. 


13. 


14. 
15. 


16. 


INIT 


RESTORE (/) ,RESTART (CLEAN) , PVMF(/),TVMF(/),BKST(/), 
LIB(/) ,RESIDENT (/) 


FGF 


MNCONF 
FIRMGEN 
BLOAD 


TSYS + TERMINATE SYSTEM 
INIT 

RESTORE 

EJ CONFIG 

TSYS 

RL 


. RESTORE, RESTART (COLD) 
. GIUF MDC CURCONF=P2P NEW_CONF=P0 


then perform a VOLPREP on the temporary P-Set so that the disk has the 
correct size and characteristics. 


See the chapter Jnstallation and Updating Facility for a description of the 
MODIFY_CONF function. 


Reload the system: 

I:RESTORE, RESTART (COLD) 

Run on-line tests and diagnostics (OLTD). 
Run the relevant off-line tests (TOLs). 


For a hardware upgrade when the CPU has been changed and the system disks 
have been reconnected, customize the site files SITE.;CATALOG, SITE.HELP, 
and SYS.URCINIT. The SITE.* files are copied from the old system disk. 


The IUF function COPY_SITEFILES is described in the chapter /nstallation 
and Updating Facility. 


See also the appendix Maintenance in a Protected Environment for the use of 
GIUF with access rights. 


Use the CONFIG utility described in the chapter Configuration to customize 
the configuration. 
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17. (Not applicable when the software MIs have been validated in the factory.) 
Validate the P-Set as follows: 
S: GIUF FUNC=VALIDP; 
Parameters are requested on the screen, using GCL line mode. 


Refer to the chapter /nstallation and Updating Facility for a description of the 
GIUF function VALIDP. 


Details of the KEY location can be provided by the Local Distribution Center. 
(The KEY validates the products that you have ordered.) 


18. You are recommended to save the whole P-Set to tape or cartridge, as 
appropriate. Use the GCL procedure SAVE DISK. 


Now proceed to the description later in this chapter to create a P2P or RP- 
Configuration. 


The basic P-set is now ready to use, and: 


e This P-set can be customized (number and size of the BKST, TVMF, PVMF, 
LIB, Spool file), if a PO is requested. 


e Build a customized P2-set (in terms of the number and size of the BKST, TVMF, 
PVMF, LIB, Spool file), and use this P-set as backup. 


e Build a customized P2-set (in terms of the number and size of the BKST, TVMF, 
PVMF, LIB, Spool file), clean this current P-set, and build a new identical 
customized P2-set, if a config with 2 identical system sets is chosen. 


NOTE: 


If a previous system disk is present on the site, the new set could be updated 
using the COPY_SITEFILES function. 
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2.4.1 


2.4.2 


2.4.3 


2-10 


Installation for Update of GCOS 7 Release 


Installation for update of a GCOS 7 Release can be done by the Bull CSE either as 
described below or, using an image of the P-Set, in exactly the same way as 
described above for a first delivery. 


Backup To Previous Release 


The time necessary for switching the processing from one Release to another is 
shorter when the old P-Set is kept on line. Therefore, you should decide if old 
P-Set disks are to be kept on line after installation of the new Release. If the old 
P-Set is not to be kept on line, it should be saved before starting the installation 
procedure. 


The old P-Set is required on line during installation to copy the SITE files from it 
to the future P-Set. If the old P-Set cannot be kept on line, the SITE files may be 
saved to tape (or cartridge) before building the new P-Set. 


Refer to the end of this chapter for a description of the backup procedure. 


Constraints 


See the paragraph "Before Beginning" above for details of the required memory 
size, number of disks for the P-Set, and minimum BSR level. 


System files must not be installed on QUOTA-controlled disks. 


Only disks defined in Hardware and Software Requirements above for each type of 
system are supported. 


Alternative Installation Procedures 


The Local Distribution Center can provide you with a SET-MEDIA, created by the 
IUF function SAVE_SET, that contains the GCOS 7 Release and the associated 
Domains necessary to build your P-Set or R-Set. This SET-MEDIA is to be used 
with the INSTAL PSET or the INSTAL RSET jobs. 


The factory can provide you with a P-MEDIA in the form of a VOLSAVE of one 
or several disks to be used with the GCL command RESTORE_DISK (RSTD). 


The Local Distribution Center can provide you with a G-MEDIA that you can use 
to update the GCOS 7 Release for the GCOS Domain only. 
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< from GCOS 7 min V7 TS 7356 > 
< from GCOS 7 earlier than V7 TS 7356 > 
P-MEDIA G-MEDIA DOMAINS-MEDIA FW-MEDIA SET-MEDIA 
or 
= on , 4 
RESTORE |_: 
Using UTIL 
> 
Old P-Set 
v 
RESTORE_DISK INSTAL_ALL or INSTAL_PSET 
v 
WORKkK-disk 
< 
FIRMWARE 
GENERATION K-MEDIA 
+ 
Auxiliary 
VALIDP media 
CONFIG vary 
{ i 
P-Set g j | 
Figure 2-3. Installation for Update Users 
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NOTE: 


The old P-Set must be loaded and running and the BSR supporting the GCOS 7 
Release must already be installed. 


Make available the required number of prepared work disks that are to 
become the P-Set. 


It is assumed that the VOLORG parameter is set at ALL. If this is not the 
case, start the CONFIG job with VOLORG=ALL, terminate the system 
(TSYS 1 under GCOS 7 and Terminate System under the Service Processor) 
and start it again, as follows: 


I: RESTORE, RESTART (COLD) 
In response to the question: NGO3 DO YOU WANT TO LOAD 


PREVIOUSLY SAVED NETWORK AND TERMINAL 
CONFIGURATIONS? (Y,N), DEFAULT=Y, answer Yes. 


Mount the G-MEDIA, FW-MEDIA, SET-MEDIA, DOMAINS-MEDIA or the 
P-MEDIA, as appropriate. 


Start the INSTAL ALL job or INSTAL_PSET job or RESTORE DISK 
command with, as appropriate: 


S: EJ INFILE=INSTAL ALL:G-md:<tape-dvc>SMFT; 

or if the current Technical Status is >=TS 7356 and SET-MEDIA is available: 
S: EJ INFILE=INSTAL PSET: set-md:<tape-dvc>SMFT; 

or 


S: RSTD; 


See the Preface for full syntax specification of tape/cartridge drives. 
INSTAL_ALL or INSTAL _PSET then requests information on the screen. 


INSTAL_ALL or INSTAL _PSET clears the disk(s) of the future P-Set, then 
allocates space for it and restores the Domains files to it. This job requires 
user SYSADMIN rights in the running SITE.CATALOG. 


INSTAL_ALL and INSTAL_PSET execute the CONFIG job which updates 
the System Device Tables in the SYS.SYSTEM file on the newly created 
system volume. 


If RSTD has been used, give values on the RESTORE DISK menu for the 
disk volume identification and the tape file image. 


For more information on the GCL command RESTORE DISK, refer to the 
IOF Terminal User's Reference Manual, Part 2. 
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Perform the following: 

LEVEL DOMAIN=FW 
Terminate the system (TSYS 1 under GCOS 7 and Terminate System under the 
Service Processor). 


Initialize the system using the boot load on the old P-Set and load GCOS 7 
from the newly-created P-Set, as follows: 


I:RESTORE (/) ,RESTART (CLEAN) , PVMF(/) ,TVMF(/),LIB(/),BKST(/) 


For other ISL parameters, refer to the GCOS 7 System Operator's Guide. 


Note that the complete RESTORE syntax need only be used once; subsequent 
RESTOREs may be run with: 


I: RESTORE 


as ISL commands are memorized by the system from one ISL session to the 
next. Note, however, that the disk supporting the SYS.SYSTEM file must be 
on line, even fora RESTART WARM. 


The question: NG03: DO YOU WANT TO LOAD PREVIOUSLY SAVED 
NETWORK AND TERMINAL CONFIGURATIONS? (Y,N), 
DEFAULT=Y should be answered with "Y". 


7. You may copy the SITE files (SITE.CATALOG, SITE.STARTUP, SITE.HELP, 


SYS.URCINIT) from the old P-Set. 


IMPORTANT: 


Do not copy help texts in French to the SYS.HELP file as they are 
incompatible. French help texts are stored only in the SITE.HELP. 


Refer to the chapter /nstallation and Updating Facility, for a description of 
the IUF function COPY_SITEFILES. Refer also to the appendix 
Maintenance in a Protected Environment for details of the use of GIUF with 
access rights. 


The P-Set is now ready for use, once you have installed the software key 
(K-MEDIA), personalized the SITE files, configured the network and 
performed software optimization, using CONFIG job parameters. For details 
of CONFIG job parameters, see the chapter CONFIG (Configuration). 


The size of some of the system files resulting from the installation procedure 
of the PO-Configuration may not be convenient for the user's processing 
requirements. Additional files may be allocated using the IUF function 
BUILD filename, where filename = BKST, LIB, PVMF, SPOOL or TVMF. 


8. You are recommended to save the whole P-Set to tape, cartridge, or cassette, as 


appropriate. Use the GCL procedure SAVE_DISK. 
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2.5 Creating a P2P Configuration 


1@s IMPORTANT: 
In a P2P Configuration, the same rules apply for system files and resident disks 


as for the P-Set. See System and Resident Disks in the Introduction. 


All files for any given Domain must be on the same volume. 


1. Make available the required number of work disks. They must be FSA disks 
for the SYSVOL, and FBO (or possibly VBO) for RSDVOL, RSDVOL1, 
NRDVOL, NRDVOLI. 


These work disks will become the P2-Set. 
2. Make available the P2-Set TAILOR parameters. 


TAILOR parameters may be stored in a command file from a library, or 
introduced during an interactive TAILOR session using the BUILDP2 
function. Refer to Chapter 6 Tailor for full details. 


3. Start the IUF function BUILDP2, as follows: 
S: GIUF FUNC=BUILDP2; 


Or: 


S: GIUF CMD='BUILDP2 COMFILE=file-name' ; 


For example: 


S: GIUF CMD='BUILDP2 COMFILE=MYLIB..TAILOR' ; 


Refer to the [UF function BUILDP2 described in the chapter /nstallation and 
Updating Facility, as well as Chapter 6 Tailor. 


4. Terminate the system (TSYS 1 under GCOS 7 and Terminate System under the 
Service Processor). 
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5. Initialize the system and load GCOS 7 from the newly created P2-Set as 
follows: 


I:RESTORE (/) ,RESTART (CLEAN) , PVMF(/) ,TVMF(/),LIB(/),BKST(/) 


If BKST, PVMF, TVMF, and/or LIB files are not located on the system disk, 
the corresponding "/" must be replaced by the relevant media name. For 
example, PVMF(pvmf-md). This does not apply to BKSTO which is always 
on the system disk. 


For other ISL parameters, refer to the GCOS 7 System Operator's Guide. 


The question: NG03 DO YOU WANT TO LOAD PREVIOUSLY SAVED 
NETWORK AND TERMINAL CONFIGURATIONS? (Y,N), 


DEFAULT=yY should be answered with "Y". 


6. You are recommended to save the whole P2-Set to tape or cartridge as 
appropriate. Use the GCL procedure SAVE DISK. 
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2.6 Creating an RP-Configuration 


1@s IMPORTANT: 
All system files must be on an FSA disk. 


All files for any given Domain must be on the same volume. 


1. Execute the IUF function SAVE_SET to create the SET-MEDIA from the 
running P-Set and reply to the questions on the menu. All GCOS 7 Domains 
must be saved. 


For further details, refer to the [UF function SAVE_SET in the chapter 
Installation and Updating Facility. 


2. Make a "prepared" work disk (FSA) available. 
This work disk will become the R-Set. 


Note that a complete VOLPREP (or PREPARE DISK) is necessary for a 
work disk that has previously been used as a system disk. For work disk 
preparation, refer to the appendix Disk VOLPREP Procedure. 


3. Start the IUF job INSTAL_RSET, as follows: 
S: EJ INFILE=INSTAL RSET: set-md:<tape-dvc>$MFT; 


where set-md is the name of the first R-SET disk. For example: 
S: EJ INFILE=INSTAL_RSET:ABCFB1:CT/M5SMFT; 


See the Preface for full syntax specification of tape/cartridge drives. 
INSTAL_RSET then requests information on the screen. 


INSTAL _RSET clears the future R-Set before allocating space for it and then 
restoring to it the system files for all the Domains. 


INSTAL_RSET executes the CONFIG job which updates the System Device 
Tables in the SYS.SYSTEM file on the newly created volume. 


4. Terminate the system (TSYS 1 under GCOS 7 and Terminate System under the 
Service Processor). 


5. Initialize the system and load GCOS 7 from the newly created R-Set, as 
follows: 


I:RESTORE, RESTART (CLEAN) , TRC (OFF) , BKST(/) , PVMF(/) ,TVMF(/) ,LIB(/) 


The question: NG03: DO YOU WANT TO LOAD PREVIOUSLY SAVED 
NETWORK AND TERMINAL CONFIGURATIONS? (Y,N), 
DEFAULT=Y should be answered with "Y". 
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During GCOS 7 loading, a message is displayed: 


JL15 SYSTEM WITHOUT BEFORE JOURNAL. IF ABNORMAL RUN 
PRLOG RC=DFPRE 6, EFNUNKN 


This message is sent because there is no SYS.JRNAL file on the R-Set. It 
may be safely ignored because a SYS.JRNAL is unnecessary on the R-Set. 


6. TSYS+ TERMINATE SYSTEM from the Service Processor. 
7. Reinitialize the P-Set, as follows: 
I: RESTORE, RESTART (CLEAN) , TRC (OFF) , BKST(/) , PVMF(/) , TVMF(/) , LIB(/) 


8. Execute the IUF function MODIFY_CONF, to transform the 
PO-Configuration into an RP-Configuration, as follows: 


S: GIUF FUNC=MODIFY_CONF; 
Parameters are then requested on the screen in GCL line mode. 


Refer to the IUF function MODIFY _CONF described in the chapter 
Installation and Updating Facility. 


9. You are recommended to save the whole R-Set to tape or cartridge, as 
appropriate. Use the GCL procedure SAVE DISK. 
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2.7 BackUp to a Previous Release in PO 
1. Execute the RESTORE SET function from the multivolume SET MEDIA 
created by the SAVE_SET function when the previous release GCOS 7 was 


running. 


2. Initialize the system and load GCOS 7 from the restored P-set. 


2.8 BackUp to a Previous Release in P2P 


Reload the previous version. Set "non-modified". 


2-18 47 A2 23US 


3. Multi-System Installation and Updating 


3.1 Introduction 


3.1.1 Purpose of this Procedure 


This procedure enables you to install and maintain system disks belonging to more 
than one DPS 7000 system. 


3.1.2 Master and Slave Systems 


A Master disk Set is created on the Master system and used to update disk Sets for 
all the Slave systems. These procedures are provided from magnetic tape or 
cartridge. 


The Master and Slave systems have fixed system disks. The systems are not 
necessarily located at the same site. A tape or cartridge image of a Master Set is 
transported to the Slave system to update the Slave Set. 
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3.1.3 General Requirements 


1. The Master and Slave systems may comprise any mix of DPS 7000 systems 
all running under the same GCOS 7 Release. 


2. Ensure that the type of media used (tape and/or cartridge) is common to both 
Master and Slave systems. 


3. Multi-system installation supports PO, P2P, and RP Configurations. 


((2)3 IMPORTANT: 

If a pair of coupled systems uses the CONFIG statement DUALSYS with the 
parameter MYSELF, the two systems cannot share one common R-Set. This is 
because recovery from the R-Set is not possible on the Slave system. The 
solution must be one of the following: 


bs 


(Preferably) two P2P-Configurations. 
Two RP-Configurations. 


Two PO-Configurations (since there is no R-Set in a PO Configuration, this is 
the least expensive configuration, but also the least secure of the three). 
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3.2 Installation Procedure 


The installation procedure of a Multi-system Set contains two steps: 


1. The "Master" step, during which the P-Set, P2-Set or R-Set (as applicable) of 
the Master system are built. 


2. The"Slave" step, in which Slave Set(s) are built for the Slave system(s). 


The installation on the Master is performed by Bull personnel in the same way as 
for an individual system (see the chapter /nstallation Procedure). Figure 3-1 
shows an overview of the master and slave system installation. 


Build P-Set, P2-Set, R-Set M 
as required on the Master system A 
S 
Tape/Cartridge - 
R 

Save 
Master disk Ss 
Set to Y 
SET-MEDIA S 
T 
E 
M 

Master 

SET-MEDIA 
Vv S 
Build Local L 
[Key] >__ copy of P-Set A 
and Firmware V 
Installation E 
S 
Y 
Build P-Set S 
Slave <« or R-Set A. 
P2-Set or Slave Disk E 
R-Set M 


Figure 3-1. Multi-System Installation 
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Saving a Set on the Master System 


1. 


These operations may be performed during normal processing. A non-running 
Master Set must be on line, for use as input to the [UF function SAVE_SET. 
The disk(s) may be a P-Set, a P2-Set, or an R-Set. All GCOS 7 Domains must 
be saved. 


Execute the IUF function SAVE_SET to create the SET-MEDIA, using the 
MEDIA name convention abcdex where: 


abcde is the user tape/cartridge prefix (in alphanumeric characters), as 
requested by the SAVE _SET function. 


x is the tape/cartridge reel sequence number. 


For further details, refer to the UF function SAVE_SET in the chapter 
Installation and Updating Facility. 


Transport the SET-MEDIA to the Slave system. See Figure 3-2. 


Sent to the SLAVE system 


M 
Master A 
Set Ss 
T 
¢ E 
SAVE_SET SSS Master R 

Set 
<O Ss 
Y 
/ SET-MEDIA Ss 
a 7 
E 
M 


Figure 3-2. Transport of the SET-MEDIA to the Slave System 


Installation on the Slave System 


Use the saved Set for installation on each slave system. 


See the chapter /nstallation Procedure for memory, hardware, and firmware 
requirements. The same chapter also gives an installation example but remember 
that each DPS 7000 model and each configuration may have specific requirements 
not dealt with in the example. 
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3.3 Updating 


3.3.1 Purpose 


The updating procedure consists essentially of applying GCOS 7, OLTD, FW, 
DSA, and GSF Technical Status, as well as software add-ons or deletions for the 
GCOS Domain. 


In a multi-system environment, the updating strategy is as follows: 


1. Apply the update to the Master System (P-Set or P2-Set, and R-Set, as 
applicable). 


2. Save the correctable system files of all GCOS 7 Domains from a Master Set 
to a SET-MEDIA, using the IUF function SAVE_SET. 


3. Update the Slave P-Set, or P2-Set, with the IUF function RESTORE SET, 
from the SET-MEDIA. 


For Slave P2P-Configurations, and for multiple-software MI configurations, the 
Updating procedure takes advantage of the opportunity of updating the non- 
running Set(s). 


For multiple MI configurations, add-on or deletion must take place separately for 
each Slave system Set(s). 


GCOS 7 Emergency Corrections installed on a Slave Set are dynamically managed 
if they have been installed on the non-updated Set. 


If SITE=1 is specified in the IUF function RESTORE_SET, the SITE patches will 
be re-applied. 


In this case, the ECs are extracted from the Set concerned, prior to updating, and 
re-applied to the same Slave Set by the IUF function RESTORE SET after restore 
termination if SITE=1 has been specified. 
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3.3.2 Master System Updating Operations 


3.3.2.1. Technical Status Application 


1. 


Execute the update function appropriate to the Domain to be modified. 
Refer to the chapter: 


Updating Domains for GCOS 

Firmware Generation (FGF) and Test and Diagnostics (OLTD) Facilities for 
FW OLTD 

The DSA Installation and Updating Facility for DSA 

GCOS 7 Service Facilities (GSF) for GSF. 


Test the update after a trial period on the Master system. 


Execute the IUF function LEVEL relevant to the Domain being considered, in 
order to update the other Master Set. 


LEVEL is described in the chapter /nstallation and Updating Facility. 


For the Slave updating procedure, execute the [UF function SAVE SET to 
obtain a SET-MEDIA from a Master Set. Save all GCOS 7 Domains. 


SAVE SET is described in the chapter /nstallation and Updating Facility. 


3.3.2.2 Application of Software Add-Ons and Deletions 


1. 
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Execute the IUF function ADD_MI or DELETE _MI. 


ADD_MI and DELETE ML are described in the chapter /nstallation and 
Updating Facility. 


Test the new MI configuration for a trial period on the Master system. 
Execute the IUF function LEVEL MI to update the other Master Set. 
LEVEL MI is described in the chapter /nstallation and Updating Facility. 


If the Slave system has the same MI configuration as the Master system, 
perform Step 4 of Technical Status Application above. 


If not, the [UF functions ADD_MI or DELETE MI (as appropriate) must be 
performed on each Slave system. 
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3.3.3 Slave System Updating Operations 


3.3.3.1 Procedure 


Either the Slave P-Set or P2-Set must be loaded and running. 


NOTE: 
There is a risk in updating a P-Set in a PO or an RP-Configuration, in a 
multi-programming environment, as several active libraries may be changed 
in the process. 


1. Fora Slave system that is being updated from a SET-MEDIA, execute the 
IUF function RESTORE _ SET relevant to the Domain updated from the 
SET-MEDIA to the Slave Set. 


Refer to Table 3-1, for updating conditions, and to the chapter Jnstallation and 
Updating Facility for the IUF functions in detail. 


2. Terminate the system (TSYS 1 under GCOS 7 and Terminate System under 
the Service Processor). 


3. Load GCOS 7 from the updated Set, as follows: 
I: RESTORE(/) , RESTART (CLEAN) 


For other ISL parameters, refer to the GCOS 7 System Operator's Guide. 


4. The other Slave Set may be updated as appropriate, after a trial period, from 
the updated Set with the IUF function LEVEL. 


LEVEL is described in the chapter /nstallation and Updating Facility. 


3.3.3.2 Selecting the Running Set or the Updated Set 


It should be noted that, if the Slave's MI configuration is different from that of the 
Master, the IUF function RESTORE SET preserves the Slave MI configuration in 
the Slave Set(s), provided that the running Set is loaded with the Slave MI 
configuration. 


The choice of running Set and updated Set, as shown in Table 3-1, must depend on 
whether: 


1. The Configuration concerned is PO, P2P or RP. 


2. The respective MI Configuration Codes are the same or not. 
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4. Installation and Updating Facility 


The Installation and Updating Facility (IUF) provides the functions and jobs that 
are used to install and maintain the GCOS 7 operating system. Access to these 
functions and jobs is via the command GIUF. 


The GIUF Command 


You can start the GIUF processor if you are logged under either of the projects 
OPERATOR or SYSADMIN. These two projects are delivered in the standard 
SITE.CATALOG; the difference between them is that OPERATOR has MAIN as 
an attribute, whereas SYSADMIN does not. 


In a "protected" GCOS 7 operating system, all TUF functions must be submitted 
under the SYSADMIN project. In an "unprotected" environment, on the other 
hand, a few of the IUF functions can be started from the OPERATOR project (refer 
to the detailed function descriptions later in this chapter). 


To apply a new Technical Status in a P2P configuration, you must be logged on 
under the SYSADMIN project, with USER=GCOS7 or USER=SYSADMIN, 
otherwise the UPDATE_GCOS function will abort when it attempts to reinstall the 
access rights on the updated Set. 


Under the OPERATOR project, you must submit IUF functions in "EJ" mode. 
Under the SYSADMIN project, you can submit [UF functions in "EJ" or 
interactive mode. 


In "EJ" mode, you have the possibility of deferred replies. In interactive mode, 
you must reply immediately. 


IMPORTANT: 
Interactive mode is recommended, on account of its enhanced operability as 
compared with "EJ" mode. 


When the GIUF command is submitted with the parameter COMMAND= or 
CMDs=, the MENU and HELP facilities are not available. 
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Syntax in Interactive Mode 


S: GIUF [{COMMAND='char100' |FUNCTION=name31}] 
[PRTFILE=file78] ; 


Syntax in Batch Mode 


S: EJ PROC=GIUF [VL=([{COMMAND='char100' | FUNCTION=name31} ] 
[PRTFILE=file78])] ; 


Parameters 

COMMAND introduces the function name and its parameters. 

FUNCTION introduces the function name if all output is to be 
displayed on the screen. 

PRTFILE introduces the name of the print file, and may be used 
with the COMMAND parameter to route printed 
output. 


Interactive Mode 


Entering the command and its parameter: 


S: GIUF CMD='LSMI R'; 


Entering only the function and requesting the LSMI menu, either: 


S: GIUF FUNC=LSMI; 


or: 


S: GIUF; 
G: LSMT; 


Requesting the GIUF menu to choose a GIUF function: 


S: GIUF; 
G: ? 
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Batch Mode 


Entering the command and its parameter: 


S: EJ PROC=GIUF VL=(CMD='LSMI R') ; 


Entering only the function and requesting LSMI parameter: 


S: EJ PROC=GIUF VL=(FUNC=LSMI) ; 


Requesting the GIUF menu to choose an IUF function: 


S: EJ PROC=GIUF; 
nn/G 
S: REP nn '?'; 


4.1.1 Environment Considerations 
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Note the following points when using the GIUF command: 


1. No catalogs must be attached. 


2. You must not modify your profile. The user profile is saved at IUF initiation 
and restored at IUF termination; hence, any modifications made during IUF 
will be lost automatically. 


3. You must not delete any GCL global variables while running IUF, because a 
set of such variables is used by IUF itself. 


4. The $*$BRK command is neither processed nor recognized during the 
running of IUF. 


5. Any cataloged files assigned with either of the commands MWINLIB or 
MWLIB are saved at IUF initiation and restored at IUF termination. 


IUF Functions and Jobs 


Functions 


ADAPT 

ADD MI 

BUILD _CLC 
BUILD _CMS 
BUILD _BKST 
BUILD HALOCK 
BUILD_JAS 
BUILD _JRNAL 
BUILD_LIB 
BUILD_MIRLOG 
BUILD _PVMF 
BUILD QM 
BUILD _QM BACKUP 
BUILD_SPDUMP 
BUILD SPOOL 


Jobs 


INSTAL_ ALL 
INSTAL_GCOS 
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BUILD_SYSDUMP 
BUILD _TVMF 
BUILDP 

BUILDP2 
COPY_SITEFILES 
DELETE MI 
DETECT SITE 
DISPLAY STATUS 
EDIT 

FSE 

LEVEL 

LEVEL MI 
LIST_MI 

MODIFY CONF 
PATCH_HLMLIB 


INSTAL_PSET 
INSTAL_RSET 


PATCH SYSTEM 
PROTECT GCOS 
RESTORE SET 
RESTORE SITE 
RESTORE SITEFILES 
SAVE_SET 

SAVE_ SITE 
SAVE_SITEFILES 
UPDATE_GCOS 
UPDATE MI 
VALIDP 
VALIDP2 
VALIDR 
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4.2 IUF Functions 


4.2.1 The ADAPT Function 
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Purpose 
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e Linkage of a P-Set to its corresponding R-Set (in an RP configuration), or of a 
non-running Set to the running Set (in a P2P configuration). 


e Change the R-Set's volume name, when the R-Set has been saved and then 
restored to another volume (only necessary when non-IUF functions, such as 
GCL procedures SAVE DISK and RESTORE DISK, have been used. The IUF 
function SAVE_SET and the IUF job INSTAL_RSET perform the necessary 
operations automatically). 


Syntax 


{ADAPT|ADP} {LINK_SET|LKSET}=1 [{MOD_RSET|MDR}=0] 


{ {PS} 


or: 


ET_NAME | PSET} | {P2SET_NAME | P2SET} }=media:devclass 


{ADAPT|ADP} {LINK_SET|LKSET}=0 {MOD_RSET|MDR}=1 


{RSET_NAME |RSET}=media:devclass 


Parameters 


LINK_ SET 


MOD RSET 


PSET_ NAME 


P2SET NAME 


if 1, link a new P-Set or P2-Set. Specification of 
LINK_SET=1 is mutually exclusive with that of 
MOD _RSET=! below. There is no default value for 
this parameter; LINK _SET=0 must explicitly 
accompany MOD_RSET=1. 


if 1, modify the name of the R-Set. Specification of 
this parameter is mutually exclusive with that of 
LINK_SET above. 


defines a new P-Set media name and devclass, to be 
linked to the R-Set in an RP configuration, or to a 
running P2-Set in a P2P configuration. 


defines a new media name and devclass for the P2-Set, 
to be linked to a running P-Set in a P2P configuration. 
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RSET NAME defines a new media name and devclass for the R-Set, 
to be modified both in the R-Set and in the linked 
P-Set. 

Environment 


The running Set may be the P-Set, the P2-Set or the R-Set. However, in a P2P 
configuration, the Set to be linked cannot be the running Set. 


If several P-Sets or P2-Sets exist in a given configuration, ADAPT must be 
executed before any IUF functions which require both Sets (R and P, or P and P2). 


ADAPT is executed implicitly by the BUILDP and BUILDP2 functions. ADAPT 
may additionally be used to link two Sets (MASTER and SLAVE) in a multi- 
system environment. 


This function is not allowed in a PO configuration since it has no relevance. 


Detailed purpose 
Checks the configuration type applicable. 
Requests input parameters, if not given in the submitted command. 


Displays the media name and devclass of the previous or current P-Set, P2-Set or 
R-Set, if not submitted with the command. 


Updates the [UF CONFSET subfile in the SYS.IUF library of both Sets, as 
appropriate: 


e RSETMD, RSETDVC 
e PSETMD, PSETDVC 
e P2SETMD, P2SETDVC. 


EXAMPLE: 


G: ADAPT LINK_SET=1 PSET=P7-901:MS/FSA 
P2SET=P27901:MS/FSA 


The P-Set, in which the SYS.CATALOG has been allocated on MS/FSA media 
P7-901, is to be linked to the P2-Set, in which the SYS.CATALOG file has been 
allocated on MS/FSA media P27901. 


G: ADP LKSET=0 MOD_RSET=1 RSET_NAME=RSETA1 :MS/FSA 


The R-Set in the installation is to become that identified by "RSETA1:MS/FSA". 
QO 
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4.2.2 The ADD_MI Function 
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Purpose 


Validates the addition of Marketing Identifiers to the P-Set in a PO- or RP 
configuration, or to the running Set in a P2P configuration, from a key delivered to 
the user. 


Syntax 


{ADD_MI|ADMI} {{KEY_FILE|KEYF}=file78 
| {KEY_CODE | KEYC}=char156}; 


Parameters 


KEY FILE identifies the name of the key file (i.e., of the 
K-MEDIA). This parameter is mutually exclusive 
with KEY CODE, below. 


KEY CODE is the code of the key, between slashes. For example: 
[identifier] /c25b67£2/ 


This parameter is mutually exclusive with KEY FILE, 
above. The optional identifier, of up to 31 
alphanumeric characters in length, is defined by Bull 
to designate the site concerned. 


Environment 
The running Set may be the P-Set, P2-Set, or R-Set. 


The modified Set is the P-Set in an RP- or PO configuration, or the running Set in a 
P2P configuration. 


The R-Set in an RP configuration, or the non-modified Set in a P2P configuration, 
must subsequently be updated with the LEVEL MI function. 


When execution is completed, a warning message indicates the action to be taken 
for new MIs to be taken into account: 


e an ISL RESTORE is required immediately, or 
e the ISL RESTORE session can be put off until the next system restart. 
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If any new product requires an ISL session as part of its installation procedure, the 
ISL RESTORE can be done at the same time. See the installation guide for the 
product concerned. 


Detailed purpose 


Requests the ADD MI parameters, if these are not supplied with the submitted 
command. 


If the KEY CODE parameter is given, its contents are stored in the IUF_KEY 
member of the SYS.IUF library. 


Calls the IUF_ADMI JCL to perform the following operations: 


e Read and decode the key. 

e Display the added MI's together with the target volume's name. 

e Request agreement on the MI's displayed. 

e Validate the added MI's in the SYS.SYSTEM file of the target Set. 


e Display on the console and write in the JOR one of the following warning 
messages indicating what action is necessary for added MIs to be taken into 
account: 


— for MIs dynamically validated: 
* ADD MI DYNAMICALLY ACCOUNTED FOR THE CURRENT GCOS7 SESSION 
* ISL RESTORE WILL ONLY BE NECESSARY AT NEXT SYSTEM RESTART 


— for MIs not dynamically validated: 
* ADD MI PROCESSED: ISL RESTORE NECESSARY 


Constraints 


Running GCOS 7-V9/TA, when MI’s concerning "Customer Dedicated Processors" 
(CDP) (MI EXSD020 or TASD002) are added, a RESTORE, RESTART (CLEAN) 
is mandatory. 

These MI’s are not concerned with GCOS 7-V10/XTA 
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EXAMPLES: 


S: GIUF CMD='ADD MI KEY _FILE=MIKEY:MIKEY:CT'; 


The key is located in the file MIKEY. 


S: GIUF CMD='ADD MI KEY _FILE=SYS.IUF..KEY'; 


The key is located in the member KEY, of the running SYS.IUF library. 


S: GIUF 
G: ADMI KEY_CODE=BP31/D76N59A2/; 


The key is supplied as a parameter entered from the keyboard. 


Q 


NOTE: 
The K-MEDIA is defined as: 


MD=MIKEY DVC=dvc EFN=MIKEY 
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4.2.3 The BUILD_BKST Function 


Purpose 


Allocation of a SYS.BKST[i] file (where 0 <= i <= 15), on a P-Set, a P2-Set, or an 
R-Set. This is a backing store file. 


NOTES: 


1. This function may be used for building the SYS.BKST file, which is 
considered as having the virtual suffix 0 for the purposes of the above 
algorithm. 


2. This file may not be allocated on mirror disks. 


Syntax 


{BUILD_BKST|BBKST} {NUMBER|NB}=n SET={P|P2|R} 


{VOLUME |VOL}=media:devclass {SIZE|SZ}=nnnn; 


Parameters 

NUMBER defines "i" in SYS.BKST[i] where 0 <=1 <= 15. 
NOTE: The first file in the Set is SYS.BKST (and not 
SYS.BKSTO). The second file is SYS.BKST1, etc. 

SET identifies the Set in which the SYS.BKSTIi file is to be 
built. 

VOLUME identifies the media and devclass names of the volume 
to contain the new SYS.BKSTi file. 

SIZE defines the size of the new SYS.BKSTi file. The 
maximum size is 65535 blocks. 

Environment 


The running Set may be the P-Set, the P2-Set, or the R-Set, as appropriate to the 
configuration concerned. 
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Detailed purpose 


The BUILD_BKST parameters are requested interactively, if these have not 
already been supplied with the command. 


The following operations are performed: 


e Deletion of any existing SYS.BKSTi file from the Set specified 


e Allocation of anew SYS.BKSTi file on the disk specified by VOLUME, and 
catalog the new file in the SYS.CATALOG belonging to the Set. 


e Formatting the new SYS.BKST[i] file's space. 


EXAMPLE: 


G: BBKST NUMBER=2 SET=P VOLUME=FSA3:MS/FSA SIZE=17000; 


ASYS.BKST2 file is to be allocated on FSA3:MS/FSA and cataloged in the 
SYS.CATALOG on the P-Set. 


Q 
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4.2.4 The BUILD_CMS Function (if applicable) 


Purpose 
Allocation of the following files on a specified FBO volume: 


SITE.CMS CSD 
SITE.CMS_CDD_namel 
SITE.CMS_CDD_name2 
SITE.CMS_DS_namel_name2 


where name! and name? correspond to the names of the two coupled systems as 
they are known in the network. These files are used for the management of 
TDS-HA. 


Syntax 


{BUILD_CMS|BCMS} CATVOL=media:devclass 
{VOLUME | VOL}=media:devclass 


{NAME1 |N1}=char4 


{NAME2 |N2}=char4; 


Parameters 
CATVOL Volume containing the SITE.CATALOG 
VOLUME Defines the media and devclass names of the volume 
to contain the new SITE.CMS* files. 
The FBO disk is shared between two coupled systems. 
NAMEI Network name of one of the coupled systems. 
NAME2 Network name of the other coupled system. 
Environment 


The running Set may be the P-Set, the P2-Set or the R-Set, as appropriate to the 
configuration concerned. 
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Detailed purpose 


The BUILD_CMS parameters are requested interactively, if they have not already 
been supplied. 


The following operations are performed: 


e Delete any existing SITE.CMS* files from the SITE.CATALOG defined in the 
command. 


e Allocate the new SITE.CMS* files on the volume defined by the VOLUME 
parameter, and catalog them in the SITE.CATALOG specified. 


EXAMPLE: 


G: BUILD_CMS CATVOL=FSA2 :MS/FSA 
VOLUME=FSA3 :MS/FSA NAME1=C001 NAME2=C002; 


The SITE.CMS CDD_C001, SITE.CMS_CDD_C002, SITE.CMS_ CSD, 
SITE.CMS_DS_C002_C001 files are to be allocated on FSA3:MS/FSA and 
cataloged in the SITE.CATALOG located on FSA2:MS/FSA 


Q 
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4.2.5 The BUILD_HALOCK Function (if applicable) 


Purpose 


Allocation of a new SITE.HALOCK file on a specified volume. It is used for 
TDS-HA recovery. 


NOTES: 
1. This file must be allocated on an FBO volume. 


2. It may not be allocated on a MIRROR volume. 


Syntax 


{BUILD_HALOCK|BHALOCK} CATVOL=media:devclass 
{VOLUME | VOL}=media:devclass 


Parameters 
CATVOL Volume containing the SITE.CATALOG 
VOLUME Defines the media and devclass names of the volume 
to contain the new SITE.HALOCK file. 
The disk is shared between two coupled systems. 
Environment 


The running Set may be the P-Set, the P2-Set or the R-Set, as appropriate to the 
configuration concerned. 
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Detailed purpose 


The BUILD_HALOCK parameters are requested interactively, if they have not 
already been supplied. The following operations are performed: 


e Delete any existing SITE.HALOCK file from the SITE.CATALOG defined in 
the command. 


e Allocate anew SITE.HALOCK file on the volume defined by the VOLUME 
parameter, and catalog it in the SITE.CATALOG specified. 


e Initialize the new SITE.HALOCK file. 


EXAMPLE: 


G: BUILD_HALOCK CATVOL=FSA2:MS/FSA VOLUME=FSA3 :MS/FSA; 


The SITE.HALOCK file is to be allocated on FSA3:MS/FSA and cataloged in the 
SITE.CATALOG located on FSA2:MS/FSA. 


Q 
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4.2.6 
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The BUILD_JAS Function 


Purpose 


Allocation of new SYS.JASBLUE, SYS.JASGREEN files on the P-Set or P2-Set 
specified, used for TDS-HA or for the function called Multiple After Journals (the 
three JAS). 


Syntax 


{BUILD_JAS|BJAS} SET={P|P2} {VOLUME|VOL}=media:devclass; 


Parameters 

SET Identifies the Set in which new SYS.JAS* files are to 
be built. 

VOLUME Defines the media and devclass names of the volume 
to contain the new SYS.JAS* files. 

Environment 


The running Set may be the P-Set, the P2-Set or the R-Set, as appropriate to the 
configuration concerned. 


Detailed purpose 


The BUILD_JAS parameters are requested interactively, if they have not already 
been supplied. 


The following operations are performed: 


e Delete any existing SYS.JAS* files from the Set defined in the command. 
e Allocate new SYS.JAS* files on the volume defined by the VOLUME 


parameter, and catalog them in the SYS.CATALOG file of the Set. 
EXAMPLE: 
G: BUILD_JAS SET=P VOLUME=FSA3 :MS/FSA; 


The SYS.JASBLUE and SYS.JASGREEN files are to be allocated on 
FSA3:MS/FSA and cataloged in the SYS.CATALOG file on the P-Set. 


Q 
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4.2.7 The BUILD_JRNAL Function 
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Purpose 


Allocation of anew SYS.JRNAL file on the P-Set, P2-Set, or R-Set specified, to 
permit use of the Before Journal. 


Syntax 
{BUILD_JRNAL | BIRNAL} 


SET={P | P2 | R} 

{VOLUME | VOL}=media:devclass 

[ {SIZE | SZ}=nnnn ] 

[ {FILEBLOCK_STZE | BLKSZ}={512 | 4096}]; 


Parameters 

SET identifies the Set in which a new SYS.JRNAL file is to 
be built. 

VOLUME defines the media and devclass names of the volume to 
contain the new SYS.JRNAL file. 

SIZE defines the size of the new SYS.JRNAL file. 

FILEBLOCK_SIZE defines the block size in bytes for the SYS.JRNAL file. 


The allowed values are 512 and 4096. 


The default value for the SIZE and FILEBLOCK_ SIZE parameters depends on the 
organization and the device class of the specified volume of allocation as shown in 
the following table: 


Device class type MS/FSA 


File block size in BYTES | 512 


Size of SYS.JRNAL file | 16368 


(size in blocks) 
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Environment 


The running Set may be the P-Set, the P2-Set, or the R-Set, as appropriate to the 
configuration concerned. 


Detailed purpose 


The BUILD_JRNAL parameters are requested interactively, if these have not 
already been supplied. 


The following operations are performed: 


e Delete any existing SYS.JRNAL file from the Set defined in the command 


e Allocate anew SYS.JRNAL file on the VOLUME defined by "media:devclass", 
and catalog it in the SYS.CATALOG file of the Set. 


EXAMPLE: 


G: BUILD_JRNAL SET=P VOLUME=P7-901:MS/FSA; 


ASYS.JRNAL file is to be allocated on P7-901:MS/FSA, and cataloged in the 
SYS.CATALOG file on the P-Set. 


Q 
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4.2.8 The BUILD_LIB Function 


Purpose 


Allocation of a SYS.LIB[i] file (where 0 <= i <= 15), on a P-Set, a P2-Set, or an 
R-Set. This is a backing store file. 


NOTES: 


1. This function may be used for building the SYS.LIB file, which is 
considered as having the virtual suffix 0 for the purposes of the above 
algorithm. 


2. This file may not be allocated on mirror disks. 


Syntax 


{BUILD_LIB|BLIB} {NUMBER|NB}=n SET={P|P2|R} 


{VOLUME |VOL}=media:devclass {SIZE|SZ}=nnnn; 


Parameters 

NUMBER defines the SYS.LIB[i] number, where 0 <= i <= 15; 
NOTE: The first file in the Set is SYS.LIB (and not 
SYS.LIBO). The second file is SYS.LIB1, etc. 

SET identifies the Set in which the SYS.LIBi file is to be 
built. 

VOLUME identifies the media and devclass names of the volume 
to contain the new SYS.LIBi file. 

SIZE defines the size of the new SYS.LIBi file. The 
maximum size is 65535 blocks. 

Environment 


The running Set may be the P-Set, the P2-Set, or the R-Set, as appropriate to the 
configuration concerned. 
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Detailed purpose 


The BUILD_LIB parameters are requested interactively, if these have not already 
been supplied with the command. 


The following operations are performed: 


e Deletion of any existing SYS.LIBi file from the Set specified. 


e Allocation of anew SYS.LIBi file on the disk specified by VOLUME, and 
catalog the new file in the SYS.CATALOG belonging to the Set. 


e Formatting the new SYS.LIB[i] file's space. 


EXAMPLE: 


G: BLIB NUMBER=2 SET=P VOLUME=FSA3 :MS/FSA SIZE=17000; 


ASYS.LIB2 file is to be allocated on FSA3:MS/FSA and cataloged in the 
SYS.CATALOG on the P-Set. 


Q 
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4.2.9 The BUILD_MIRLOG Function (if applicable) 


47 A2 23US 


Purpose 


Allocation of a new SITE.MIRLOG file on a specified volume, used for the 
recovery of mirror disks. 


NOTES: 
1. This file must be allocated on an FBO volume. 


2. It may not be allocated on a MIRROR volume. 


Syntax 


{BUILD_MIRLOG|BMIRLOG} CATVOL=media:devclass 
{VOLUME | VOL}=media:devclass 


Parameters 

CATVOL Volume containing the SITE.CATALOG 

VOLUME Defines the media and devclass names of the volume 
to contain the new SITE.MIRLOG file. 

Environment 


The following operations are performed: 
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Detailed purpose 


The BUILD_MIRLOG parameters are requested interactively, if they have not 
already been supplied. 


The JCL sequence [UF BUILD _NONEFBO is called to perform the following 
operations: 


e Delete any existing SITE.MIRLOG file from the SITE.CATALOG defined in 
the command. 


e Allocate anew SITE.MIRLOG file on the volume defined by the VOLUME 
parameter, and catalog it in the SITE.CATALOG specified. 


e Initialize the new SITE.MIRLOG file. 


EXAMPLE: 
G: BUILD_MIRLOG CATVOL=FSA2:MS/FSA VOLUME=FSA3 :MS/FSA; 


The SITE.MIRLOG file is to be allocated on FSA3:MS/FSA and cataloged in the 
SITE.CATALOG on FSA2:MS/FSA. 


Q 
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4.2.10 The BUILD_PVMF Function 


Purpose 


Allocation of a SYS.PVMF{i] file (where 0 <= i <= 15), on a P-Set, a P2-Set, or an 
R-Set. This is a backing store file. 


NOTES: 


1. This function may be used for building the SYS.PVMF file, which is 
considered as having the virtual suffix 0 for the purposes of the above 
algorithm. 


2. This file may not be allocated on mirror disks. 


Syntax 


{BUILD_PVMF|BPVMF} {NUMBER|NB}=n SET={P|P2|R} 
{VOLUME |VOL}=media:devclass {SIZE|SZ}=nnmn; 


Parameters 

NUMBER defines the SYS.PVMF[i] number, where 0 <= i <= 
15. 

NOTE: The first file in the Set is SYS.PVMF (and not 
SYS.PVMFO). The second file is SYS.PVMF1, etc. 

SET identifies the Set in which the SYS.PVMFi file is to be 
built. 

VOLUME identifies the media and devclass names of the volume 
to contain the new SYS.PVMF' file. 

SIZE defines the size of the new SYS.PVMFi file. The 
maximum size is 65535 blocks. The size is actually 
allocated in units of 64 Kbytes. 

Environment 


The running Set may be the P-Set, the P2-Set, or the R-Set, as appropriate to the 
configuration concerned. 
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Detailed purpose 


The BUILD_PVMF parameters are requested interactively, if these have not 
already been supplied with the command. 


The following operations are performed: 


e Deletion of any existing SYS.PVMFi file from the Set specified 


e Allocation of anew SYS.PVMFi file on the disk specified by VOLUME, and 
catalog the new file in the SYS.CATALOG belonging to the Set. 


e Formatting the file space on the new SYS.PVMF{i]. 


EXAMPLE: 


G: BPVMF NUMBER=2 SET=P VOLUME=FSA3:MS/FSA SIZE=17000; 


ASYS.PVME72 file is to be allocated on FSA3:MS/FSA and cataloged in the 
SYS.CATALOG on the P-Set. 


Q 
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4.2.11 The BUILD_QM Function 


Purpose 


Allocation of anew SYS.QM file on the P-Set, P2-Set, or R-Set, specified, used for 
sending operator messages. 


Syntax 


{BUILD_QM|BQM} SET={P|P2|R} {VOLUME|VOL}=media:devclass 
{SIZE|SZ}=nnnn; 


Parameters 

SET identifies the Set in which a new SYS.QM file is to be 
built. 

VOLUME defines the media and devclass names of the volume to 
contain the new SYS.QM file. 

SIZE defines the size of the new SYS.QM file. 

Environment 


The running Set may be the P-Set, the P2-Set, or the R-Set, as appropriate to the 
configuration concerned. 
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Detailed purpose 


The BUILD_QM parameters are requested interactively, if these have not already 
been supplied. 


The following operations are performed: 


e Delete any existing SYS.QM file from the Set defined in the command 


e Allocate anew SYS.QM file on the VOLUME defined by "media:devclass", and 
catalog it in the SYS.CATALOG file of the Set. 


EXAMPLE: 


G: BUILD_QM SET=P VOLUME=P7-901:MS/FSA; 


ASYS.QM file is to be allocated on P7-901:MS/FSA, and cataloged in the 
SYS.CATALOG file on the P-Set. 


Q 
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4.2.12 The BUILD_QM_BACKUP Function 


Purpose 


Allocation of anew SYS.QM_ BACKUP file on the P-Set, P2-Set, or R-Set 
specified, used in case of failure of the SYS.QM file. 


Syntax 


{BUILD_QM_BACKUP | BOM_BACKUP | BOMB} 


SET={P|P2|R} {VOLUME|VOL}=media:devclass {SIZE|SZ}=nnnn; 


Parameters 

SET identifies the Set in which a new SYS.QM BACKUP 
file is to be built. 

VOLUME defines the media and devclass names of the volume to 
contain the new SYS.QM_ BACKUP file. 

SIZE defines the size of the new SYS.QM BACKUP file. 

Environment 


The running Set may be the P-Set, the P2-Set, or the R-Set, as appropriate to the 
configuration concerned. 
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Detailed purpose 


The BUILD_QM BACKUP parameters are requested interactively, if these have 
not already been supplied. 


The following operations are performed: 


e Delete any existing SYS.QM BACKUP file from the Set defined in the 
command 


e Allocate anew SYS.QM BACKUP file on the VOLUME defined by 
"media:devclass", and catalog it in the SYS.CATALOG file of the Set. 


EXAMPLE: 


G: BUILD_QM BACKUP SET=P VOLUME=P7-901:MS/FSA; 


ASYS.QM_ BACKUP file is to be allocated on P7-901:MS/FSA, and cataloged in 
the SYS.CATALOG file on the P-Set. 


Q 


4-28 47 A2 23US 


Installation and Updating Facility 


4.2.13. The BUILD _SPDUMP Function 
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Purpose 


Allocation of new SYS.SPDUMP file on the P-Set or P2-Set specified, used for 
storing binary dumps of TDS and system processors. 


Syntax 


{BUILD_SPDUMP|BSPDUMP} SET={P|P2|R} 
{VOLUME | VOL}=media:devclass 


Parameters 

SET Identifies the Set in which anew SYS.SPDUMP file is 
to be built. 

VOLUME Defines the media and devclass name of the volume to 
contain the new SYS.SPDUMFP file. 

Environment 


The running Set may be the P-Set, the P2-Set or the R-Set, as appropriate to the 
configuration concerned. 


Detailed purpose 


The BUILD_SPDUMP parameters are requested interactively, if they have not 
already been supplied. 


The following operations are performed: 


e Delete any existing SYS.SPDUMP file from the Set defined in the command 


e Allocate new SYS.SPDUMP file on the volume defined by "media:devclass", 
and catalog it in the SYS.CATALOG file of the Set. 


EXAMPLE: 
G: BUILD_SPDUMP SET=P VOLUME=FSA3:MS/FSA; 


ASYS.DUMFP file is to be allocated on FSA3:MS/FSA and cataloged in the 
SYS.CATALOG file on the P-Set. 


Q 
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4.2.14 The BUILD _SPOOL Function 


Purpose 


Allocation of a SYS.SPOOLi file (where 0 <= i <= 9), on a P-Set, a P2-Set, or an 
R-Set, as appropriate to the installation concerned, used for the management of IOF 
contexts. 


Syntax 


{BUILD_SPOOL|BSPOOL} {NUMBER|NB}=n SET={P|P2|R} 


{VOLUME | VOL}=media:devclass 


{SIZE|SZ}=nnnn; 


Parameters 

NUMBER specifies the number "i" of the SYS.SPOOLi file 
where 0 <=1<=9. 

SET identifies the Set in which a new SYS.SPOOLi file is 
to be built. 

VOLUME defines the media and devclass names of the resident 
volume on which a new SYS.SPOOLi file is to be 
built. 

SIZE defines the size of the new SYS.SPOOLi file. 

Environment 


The running Set may be the P-Set, the P2-Set, or the R-Set, as appropriate to the 
configuration concerned. 


The SYS.SPOOL file must be allocated on a resident volume. 
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Detailed purpose 


The BUILD_SPOOL parameters are requested interactively, if these have not 
already been supplied. 


The following operations are performed: 


e Delete any existing SYS.SPOOLi file from the Set specified 


e Allocate anew SYS.SPOOLi file on the disk defined by media:devclass, and 
catalog it in the Set's SYS.CATALOG file. 


e Modify the sharing parameter of the SYS.SPOOLI file, in the SYS.CATALOG 
of the Set, to SHARE = NORMAL. 

EXAMPLE: 

G: BSPOOL NUMBER=6 SET=P2 VOLUME=FSA3:MS/FSA SIZE=30000; 


ASYS.SPOOL6 file is to be allocated on FSA3:MS/FSA and cataloged in the 
SYS.CATALOG file on the P2-Set. 


Q 
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4.2.15 The BUILD _SYSDUMP Function 


Purpose 


Allocation of anew SYS.SYSDUMFP file on the P-Set, or P2-Set specified, used 
for storing GCOS 7 dumps after a crash. 


NOTE: 
This file may not be used on mirror disks. 


Syntax 
{BUILD_SYSDUMP|BSYSDUMP} SET={P|P2} 
{VOLUME | VOL} =media:devclass 


{SIZE|SZ}=nnnn; 


Parameters 

SET identifies the Set in which a new SYS.SYSDUMP file 
is to be built. 

VOLUME defines the media and devclass names of the volume to 
contain the new SYS.SYSDUMF file. 

SIZE defines the size of the new SYS.SYSDUMP file. The 
maximum size is 65535 blocks. 

Environment 


The running Set may be the P-Set, P2-Set, or R-Set, as appropriate to the 
configuration concerned. 
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Detailed purpose 


The SYS.SYSDUMP requires initializing. GIUF BUILD_SYSDUMP is 
mandatory to rebuild this file. 


The BUILD_SYSDUMP parameters are requested interactively, if these have not 
already been supplied. 


The following operations are performed: 


e Delete any existing SYS.SYSDUMP file from the Set defined in the command 


e Allocate anew SYS.SYSDUMP file on the VOLUME defined by 
"media:devclass", and catalog it in the SYS.CATALOG file of the Set. 


e Format the file space of the new SYS.SYSDUMP. 


EXAMPLE: 


G: BUILD_SYSDUMP SET=P SIZE=80000 VOLUME=FSA3 :MS/FSA; 


ASYS.SYSDUMP file of 80000 blocks is to be allocated on FSA3:MS/FSA, and 
cataloged in the SYS.CATALOG file on the P-Set. 


Q 
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4.2.16 The BUILD_TVMF Function 


Purpose 


Allocation of a SYS.TVMF{i] file (where 0 <= i <= 15), on an P-Set, a P2-Set, or 
an R-Set. This is a backing store file. 


NOTES: 


1. This function may be used for building the SYS.TVMF file, which is 
considered as having the virtual suffix 0 for the purposes of the above 
algorithm. 


2. This file may not be allocated on mirror disks. 


Syntax 


{BUILD_TVMF|BTVMF} {NUMBER|NB}=n SET={P|P2|R} 


{VOLUME |VOL}=media:devclass {SIZE|SZ}=nnnn; 


Parameters 

NUMBER defines the SYS.TVMF{i] number, where 0 <= 1 <= 15. 
NOTE: The first file in the Set is SYS.TVMF (and not 
SYS.TVMFO), the second file is SYS.TVMF1, etc. 

SET identifies the Set in which the SYS.TVMFi file is to be 
built. 

VOLUME identifies the media and devclass names of the volume 
to contain the new SYS.TVMF' file. 

SIZE defines the size of the new SYS.TVMFi file. The 
maximum size is 65535 blocks. The size is actually 
allocated in units of 64 Kbytes. 

Environment 


The running Set may be the P-Set, the P2-Set, or the R-Set, as appropriate to the 
configuration concerned. 
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Detailed purpose 


The BUILD_TVMF parameters are requested interactively, if these have not 
already been supplied with the command. 


The following operations are performed: 


e Deletion of any existing SYS.TVMFi file from the Set specified 


e Allocation of anew SYS.TVMFi file on the disk specified by VOLUME, and 
catalog the new file in the SYS.CATALOG belonging to the Set. 


e Formatting the new SYS.TVMF{i] file's space. 


EXAMPLE: 


G: BIVMF NUMBER=2 SET=P VOLUME=FSA3:MS/FSA SIZE=17000; 


ASYS.TVMF2 file is to be allocated on FSA3:MS/FSA and cataloged in the 
SYS.CATALOG on the P-Set. 


Q 
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4.2.17 The BUILDP Function 


Purpose 


Creation of a P-Set linked to the R-Set. BUILDP activates the TAILOR processor. 
This function may also be used to copy the set of DSA files from the R-Set to an 
already created P-Set, and to create any non-existent files with DIUF. However, it 
must not be used for any other purpose because there could be a danger of 
inconsistent results. 


Syntax 


{BUILDP|BP} [{COMFILE|CMDF}=file78]; 


Parameters 

COMFILE identifies the file containing the TAILOR command 
input to enable a P-Set to be built. 

Environment 


This function must be submitted under the SYSADMIN project, and is not allowed 
on a PO configuration. 


RP configurations: 


The running Set may be either the R-Set to be linked with the new P-Set, or an 
already-created P-Set. 


The input Set is the R-Set. 


The P-Set system disk (as defined by the TAILOR command SYSVOL) must be a 
disk formatted in FBO. 


P2P configurations: 


This is not the normal purpose of the BUILDP function and its use in a P2P 
configuration can lead to inconsistencies. 
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Detailed purpose 


When the COMFILE is supplied, the TAILOR processor is activated in batch mode 
with the COMFILE as input. 


As an alternative to COMFILE, the member IUF_COMF_ TAIL, which is located 
in the SYS.IUF library may be used, after modifications. 


If COMFILE is not supplied, the TAILOR processor is activated in interactive 
mode, or aborted in batch mode, as appropriate. 


This function checks the type of configuration concerned. It is not allowed in a PO 
configuration where, if it is attempted, the following message is sent: 


"FUNCTION NOT ALLOWED IN A PO CONFIGURATION" 
P-Set files are allocated, or copied from the R-Set (or P2-Set). 


The PSETMD and PSETDVC are updated in the IUF_CONFSET member of the 
SYS.IUF library in both Sets, that is the newly created P-Set plus the R-Set or 
P2-Set as appropriate. 


The latest COMSET is copied from the R-Set (or P2-Set) to the new P-Set. 


NOTE: 
The IUF_CONFSET member of the SYS.IUF on the old P-Set is not updated 
and will therefore be inconsistent with the R-Set (or P2-Set) with which it 
remains linked. 


EXAMPLE: 


G: BUILDP COMFILE=file78; 


The command file designated by "file78" contains a series of TAILOR commands 
to be used during the BUILDP execution. For an example of COMFILE, refer to 
the BUILDP2 function. 


Q 
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4.2.18 The BUILDP2 Function 


Purpose 


Creation of a P2-Set from the P-Set in an RP or PO configuration. The P2-Set 
contains all the P-Set files, although the number of disks may be different. 
BUILDP2 activates the TAILOR processor. This function may also be used to 
copy the set of DSA files from a P-Set to a P2-Set, and to create any non-existent 
files with DIUF. However, it must not be used for any other purpose because there 
could be a danger of inconsistent results. 


Syntax 


{BUILDP2|BP2} [{COMFILE|CMDF}=file78]; 


Parameters 

COMFILE names the file containing the input TAILOR 
commands for use in building a P2-Set from a P-Set. 

Environment 


This function must be submitted under the SYSADMIN project. 


The running Set may be either the P-Set to be linked with the P2-Set, or an 
already-created P2-Set. 


The input Set is the P-Set. 


The P2-Set system disk (as defined by the TAILOR command SYSVOL) must be a 
disk formatted in FBO. 


P2P configurations: 


This is not the normal purpose of the BUILDP2 function and its use in a P2P 
configuration can lead to inconsistencies. 
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Detailed purpose 


TAILOR may be activated with the last set of commands of the P-Set, and the new 
volume values. 


P2-Set files are allocated, or copied from the P-Set. 


Updating of the [UF CONFSET member in the SYS.IUF library in both the newly 
created P-Set and P2-Set: 
P2SETMD, P2SETDVC, CONF = P2P. 


NOTE: 
The IUF_CONFSET member of the SYS.IUF on the old P-Set is not updated 
and will therefore be inconsistent with the R-Set (or P2-Set) with which it 
remains linked. 


EXAMPLES: 


BP2 COMFILE=fi1e78; 


The command file designated by "file78" contains a series of TAILOR commands 
to be used during the BUILDP2 execution. 


S: GIUF; 
G: BUILDP2 COMFILE=LIB.. SUBFILE:MEDIA:MS/FSA; 


Contents of SUBFILE: (*) 


TLRRESET WEAK; Cx*) 

TLRGEN FILESET=GCOS COMSET=LAST; 
SYSVOL MEDIA=FSASYS DEVCLASS=MS/FSA; 
RSDVOL MEDIA=FSARSD DEVCLASS=MS/FSA; 
NRDVOL MEDIA=FSANRD DEVCLASS=MS/FSA; 


BKST1 TO=RSD SIZE=30000; 

KNODET SIZE=5000; 

SPOOL TO=RSD SIZE=510; 

SYO PRES=1 TO=RSD SIZE=20000 INCRSIZE=85 
MAXSIZE=99998; 

EOGEN; 

TLRGEN FILESET=FW COMSET=LAST; 

FWGEN TO=NRD; 

EOGEN; 


TLRGEN FILESET=GSF COMSET=LAST; 
GSFGEN TO=RSD; 


TLRGEN FILESET=DSA COMSET=LAST; 
SAFILES PRES=1 TO=RSD; 


TLREXEC FILESET=GCOS ; 
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IREXEC FILESET=FW; 
IREXEC FILESET=OLTD; 
LREXEC FILESET=DSA; 
LREXEC FILESET=GSF ; 


(*) The member IUF_COMF TAIL, which is located in the SYS.IUF library may 
be used as a COMFILE after modifications. 


(**) For the first launching of TAILOR, the TLRRESET keyword WEAK must 
not be used. TLRRESET STRONG is the default value. 
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4.2.19 The COPY_SITEFILES Function 


47 A2 23US 


Purpose 


Copies the contents of a site file (SYS.URCINIT, SITE.CATALOG, SITE.HELP, 
SITE.STARTUP, SYS.SITE.SL, SYS.SITE.BIN, SYS.DSACONF, 
SYS.DSACORE) from one Set to another Set. Used primarily for copying the site 
files between the system Set of an old GCOS 7 Release to the Set being built for a 
new Release, this function may also be used in RP- and P2P configurations for 
copying a modified site file from one of the system's Sets to its other Set. 


Syntax 


{COPY_SITEFILES|CPSITE} {FILE|F}=char12 INVOL=media:devclass 


OUTVOL=media:devclass; 


When FILE=SITE.CATALOG: 


[ {CATBUILD|CATB}={0|1}] 

[ {IN_ACCRIGHT | INACCR}={0|1}] 

[ {RUN_ACCRIGHT | RUNACCR}={0|1}] 

[ {RUN_OUTPUT | RUNOUT}={0|1}]; 
When CATBUILD=1: 

NBOBJ=dec5 ; 


The RUN_OUTPUT parameter is required. 
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When FILE=SITE.STARTUP: 

[ {PREALLOC | PALC}={0|1}] 

[ { STUP_OUTVOL | STUPOV}=media:devclass] 
[ {IN_ACCRIGHT | INACCR}={0|1}] 

[ {RUN_ACCRIGHT | RUNACCR}={0|1}]; 

When PREALLOC=1: 


[{SIZE|SZ}=dec8] ; 


When FILE=SITE.HELP: 

[ {PREALLOC | PALC}={0|1}] 

[ {HELP_OUTVOL | HELPOV}=media:devclass] 
[ {IN_ACCRIGHT | INACCR}={0]1}] 

[ {RUN_ACCRIGHT | RUNACCR}={0|1}]; 

When PREALLOC=1: 


[{SIZE|SZ}=dec8] ; 


When FILE=SYS.URCINIT or SYS.SITE.SL or SYS.SITE.BIN: 
[ {PREALLOC | PALC}={0|1}] 
When PREALLOC=1: 


[{SIZE|SZ}=dec8] ; 


When FILE=SYS.DSACONF or SYS.DSACORE: 
[ {PREALLOC | PALC}={0|1}] 

[ {DSA_OUTVOL | DSAOV}=media:devclass] 
When PREALLOC=1: 


[{SIZE|SZ}=dec8] ; 
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FILE 


INVOL 


OUTVOL 
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names the file to be copied; this must be 
SYS.URCINIT, SITE.CATALOG, SITE.STARTUP, 
SITE.HELP, SYS.SITE.SL, SYS.SITE.BIN, 
SYS.DSACOMNF, or SYS.DSACORE 


identifies the media name and devclass of the volume 
containing: 


— the input SITE.CATALOG file, when FILE = 
{SITE.CATALOG|SITE.STARTUP|SITE.HELP} 


— the input SYS.CATALOG file, when FILE = 
{SYS.URCINIT|SYS.SITE.SL|SYS.SITE.BIN 
ISYS.DSACONF|SYS.DSACORE} 


identifies the media name and devclass of the volume 
containing: 


— the output SITE.CATALOG file, when FILE = 
{SITE.CATALOG|SITE.STARTUP|SITE.HELP} 


— the output SYS.CATALOG file, when FILE = 
{SYS.URCINIT|SYS.SITE.SL|SYS.SITE.BIN 
ISYS.DSACONF|SYS.DSACORE} 


When FILE = SITE.CATALOG: 


CATBUILD 


IN_ACCRIGHT 


RUN_ACCRIGHT 


RUN_OUTPUT 


NBOBJ 


if 1, any existing SITE.CATALOG is deleted from the 
OUTVOL and a new one built. The output 
SITE.CATALOG must not be the running one. 


= | when access rights are set on the input 
SITE.CATALOG 


= | when access rights are set on the running 
site. CATALOG 


= 1 if the output Set is the running Set. This parameter 
must be specified in agreement with the OUTVOL 
parameter. RUN OUTPUT must be specified 
explicitly as either 1 or 0, if both IN ACCRIGHT = 1 
and RUN ACCRIGHT = 0 are defined; as 0 if 
CATBUILD = 1 is defined. In all other cases, the 
value of 0 is applied. 


defines the approximate maximum number of objects 
to be accommodated in the SITE.CATALOG to be 
built. 


4-43 


GCOS 7 System Installation Configuration and Updating Guide 


4-44 


When FILE = SITE.STARTUP: 


PREALLOC if 1, space is allocated for a SITE.STARTUP file on the 
volume named by STUP_OUTVOL 

STUP_OUTVOL identifies the media name and devclass of the volume 
to contain the new SITE.STARTUP file. 

SIZE defines the size of the new SITE.STARTUP file. 

IN_ACCRIGHT = | when access rights are set on the input 
SITE.CATALOG 

RUN_ACCRIGHT = | when access rights are set on the running 
SITE.CATALOG. 


When FILE = SITE.HELP: 


PREALLOC if 1, space is allocated for a SITE.HELP file on the 
volume named by HELP_OUTVOL 

HELP_OUTVOL identifies the media name and devclass of the volume 
to contain the new SITE.HELP file. 

SIZE defines the size of the new SITE.HELP file. 

IN _ACCRIGHT = | when access rights are set on the input 
SITE.CATALOG 

RUN_ACCRIGHT = | when access rights are set on the running 
SITE.CATALOG. 


When FILE = SYS.URCINIT or SYS.SITE.SL or SYS.SITE.BIN: 


PREALLOC if 1, space is allocated fora SYS.URCINIT or 
SYS.SITE.SL or SYS.SITE.BIN file on the volume 
named by OUTVOL 

SIZE defines the size of the new SYS.URCINIT or 


SYS.SITE.SL or SYS.SITE.BIN file. 
When FILE = SYS.DSACONF or SYS.DSACORE: 


PREALLOC if 1, space is allocated fora SYS.DSACONF or 
SYS.DSACORE file on the volume named by 
DSA_OUTVOL 

DSA_OUTVOL identifies the media name and devclass of the volume 


to contain the new SYS.DSACOMF or 
SYS.DSACORE file. This volume must be in FBO 
organization. 
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SIZE defines the size of the new SYS.DSACONF or 
SYS.DSACORE file. 


Environment 
The running Set may be the P-Set, P2-Set, or R-Set. 


In PO configurations, this function is used only for copying essential site files from 
the Set containing an old GCOS 7 Release to that being built for a new Release. 


The input and output volumes may be both of the same type and organization or 
each of a different type and organization. 


Files may be copied using the COPY_SITEFILES function: 
From an FBO site to another FBO site 
From an VBO site to an FBO site. 

However, they cannot be copied from an FBO site to a VBO site. 


A Migration Tool is available for transferring files from an FBO site to a VBO 
site. File migration can take place on the same site, or from one site to another. 
The Migration Tool is reserved for users logged on under the SYSADMIN project, 
and is called by the GCL command MNMIG. For more information, refer to the 
File Migration Tool User's Guide. 


The user must be logged on under the SYSADMIN project, in order to be able to 
copy the SITE.CATALOG. 


The running SITE.CATALOG cannot be deleted and rebuilt (by specifying 
CATBUILD=1 when RUN OUTPUT=1). 


When the input SITE.CATALOG has its access rights validated: 


e The output SITE.CATALOG will also have its access rights validated; note that 
private catalogs' access rights (together with their master directories in the 
SITE.CATALOG) cannot be moved unless all the objects concerned have the 
appropriate access rights in the output SITE.CATALOG as well. The easiest 
way to move master directories together with the corresponding private catalog 
access rights, is to rebuild the new SITE.CATALOG (by specifying 
CATBUILD=1). 


e Ifthe disk supporting either the input or the output SITE.CATALOG is not the 
running disk, the running disk's access rights are temporarily validated for the 
duration of the job's execution. 
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When a new SITE.CATALOG file is built in output, the following files must be 
cataloged in the new SITE.CATALOG: 


SITE.STARTUP 

SITE.HELP 

SITE.IN 

and, when they exist, the SITE.CMS *, SITE.HALOCK and SITE.MIRLOG 
files. 


When the new site catalog is updated only (CATBUILD=0), the entries for the 
following files are not modified: 


SITE.STARTUP 

SITE.HELP 

SITE.IN 

and, when they exist, the SITE.CMS _* and SITE.HALOCK files. 


The SITE.MIRLOG and other cataloged files keep the characteristics of the input 
SITE.CATALOG. 


The SITE.STARTUP and SITE.HELP input files must both be cataloged. 


Fixed Disk Considerations: 


e When copying site files from a site which has only fixed disks to another site, 
magnetic tapes or cartridges are used as a vehicle. 


e In this situation, the [UF functions SAVE _SITEFILES and 
RESTORE _SITEFILES must be used. 


Detailed purpose 


This function requests the COPY_SITEFILES parameters, if these have not already 
been supplied with the command. 


The following files may be copied: 


SYS.URCINIT SITE.CATALOG 
SYS.SITE.BIN SITE.HELP 
SYS.SITE.SL SITE.STARTUP 
SYS.DSACONF SYS.DSACORE 


This function calls the JCL, as appropriate, for one of the following: 


IUF_CATCOPY, which uses the CATMOVE utility to copy the 
SITE.CATALOG file 


IUF_STPCOPY, which uses the LIBMAINT processor to move the 
SITE.STARTUP file 
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IUF_HELPCOPY, which uses the LIBMAINT processor to move the 
SITE.HELP file 


IUF_URCCOPY, which uses the standard step H_URFCP to copy the 
SYS.URCINIT file. 


IUF_DSACOPY, which uses the LIBMAINT processor to move the 
SYS.DSACONF and SYS.DSACORE files 


IUF_SITECOPY, which uses the LIBMAINT processor to move the SYS.SITE.SL 
and SYS.SITE.BIN files. 


EXAMPLES: 


G: CPSITE FILE=SITE.CATALOG INVOL=P1V9 :MS/FSA 
OUTVOL=P2V9 :MS/FSA; 


The SITE.CATALOG file is to be copied from the Set designated by 
"P1V9:MS/FSA" to the Set designated by "P2V9:MS/FSA". 


G: CPSITE FILE=SITE.STARTUP INVOL=P1V9 :MS/FSA 
OUTVOL=P2V9 :MS/FSA; 


The SITE.STARTUP file is to be copied from the Set designated by 
"P1V9:MS/FSA" to the Set designated by "P2V9:MS/FSA". 


G: COPY_SITEFILES FILE=SYS.URCINIT INVOL=P1V9 :MS/FSA 
OUTVOL=P2V9 :MS/FSA; 


The SYS.URCINIT file is to be copied from the Set designated by 
"P1V9:MS/FSA" to the Set designated by "P2V9:MS/FSA". 


G: COPY_SITEFILES FILE=SITE.HELP INVOL=P1V9 :MS/FSA 
OUTVOL=P2V9 :MS/FSA; 


The SITE.HELP file is to be copied from the Set designated by "P1V9:MS/FSA" to 
the Set designated by "P2V9:MS/FSA". 


G: CPSITE FILE=SYS.DSACONF INVOL=P1V9 :MS/FSA 
OUTVOL=P2V9 :MS/FSA; 


The SYS.DSACOMF file is to be copied from the Set designated by 
"P1V9:MS/FSA" to the Set designated by "P2V9:MS/FSA". 


Q 
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The DELETE_MI Function 


Purpose 


Invalidation of deleted Marketing Identifiers from the P-Set in an RP configuration 
or PO configuration, or from the running Set in a P2P configuration, using a key 
delivered to the user. 


Syntax 


{DELETE_MI|DLMI} {{KEY_FILE|KEYF}=file78 
| {KEY_CODE | KEYC}=char156}; 


Parameters 


KEY FILE identifies the file name of the K-MEDIA. This 
parameter is mutually exclusive with KEY_ CODE, 
below. 


KEY CODE supplies the code of the key, between slashes; for 
example: 


[identifier ]/c25b67f2/ 


This parameter is mutually exclusive with KEY FILE, 
above. The optional identifier, of up to 31 
alphanumeric characters in length, is defined by Bull 
to designate the site concerned. 


Environment 
The running Set may be the P-Set, P2-Set, or R-Set. 


The modified Set is the P-Set in an RP- or PO configuration, or the running Set in a 
P2P configuration. 


The R-Set in an RP configuration, or the non-modified Set in a P2P configuration, 
must subsequently be updated with the LEVEL MI function. 


Deletion of the MIs is taken into account dynamically for the current GCOS 7 
session. 


An ISL RESTORE session is not necessary until the next system restart. 
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Detailed purpose 


This function requests the DELETE MI parameters, if these are not submitted with 
the command. 


If the KEY CODE parameter has been given, its contents are stored in the 
SYS.IUF subfile IUF_KEY. 


The IUF_DLMI JCL is called, to perform the following operations: 


e Read and decode the key 

e Display the deleted MI's, together with the target volume's name 

e Request agreement on the displayed MIs 

e Invalidate deleted MI's from the SYS.SYSTEM file in the target Set. 

e Display on the console and write in the JOR the following warning message: 


* DELETE MI DYNAMICALLY ACCOUNTED FOR THE CURRENT SESSION 
* ISL RESTORE WILL BE ONLY NECESSARY AT NEXT SYSTEM RESTART 


Constraints 


Running GCOS 7-V9/TA, when MI’s concerning "Customer Dedicated Processors" 
(CDP) (MI EXSD020 or TASD002) are deleted, a 

RESTORE, RESTART (CLEAN) is mandatory. 

These MI’s are not applicable with GCOS 7-V10/XTA. 


EXAMPLE: 


S: GIUF 
G: DLMI KEY_FILE=file78; 


MI\(s) are to be invalidated, according to a key contained in a file designated by 
"file78". 


S: GIUF 
G: DLMI KEY_CODE=/C25B67F2/; 


The key is supplied as a parameter entered from the keyboard. 


Q 


NOTE: 
The K-MEDIA is defined as: 


MD=MIKEY DVC=dvc EFN=MIKEY 
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The DETECT_SITE Function 


Purpose 


DETECT_SITE must be run before applying a new Technical Status (with 
UPDATE GCOS). When a new Technical Status is applied, the software patches 
that have already been added (since the previous Technical Status) are not 
re-applied when UPDATE_GCOS is run. DETECT_SITE checks that the absence 
of these patches does not create a software regression. 


The software patches concerned are those of the modules corrected in source code 
in the new Technical Status. 


The DETECT_SITE function requires a G-MEDIA (which contains the new 
Technical Status) and, optionally, a PATCH-MEDIA (which contains the equivalent 
patches, applicable to the new Technical Status). The PATCH-MEDIA may be 
added after the G-MEDIA. 


For XTA system, since GCOS 7 TS 9920, the G-MEDIA and PATCH-MEDIA can 
now be a CD-ROM. In this case, the content of these CD-ROM must be transferred 
on a GCOS DISK using a script located on the CD-ROM, before using the 
DETECT_SITE command (see "Using CD-ROM on XTA Systems"). 


Syntax 


{DETECT_SITE|DTST} INVOL1=media:devclass [INVOL2=media:devclass] 


[ {DISPLAY |D}={1]|0}]; 


Parameters 


INVOL1 Identifies the media name(s) and device class of the 
volumes containing the Technical Status. The 
syntax is: 


media-name] [/media-name2[/media-name3]]: 
<tape-dvce> 


or 
Gxxxx:MS (xxxx is the ts name , for example 9920) 


INVOL2 Identifies the media-name(s) and device class of the 
volume containing the PATCH-MEDIA. The syntax 
is: 
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media-name 1[/media-name2]:<tape-dve> 
or 
DTyww:MS (DTyww is the name of PATCH-MEDIA) 


If this parameter is not given a value, the 
DETECT SITE function produces the list of site 
patches, indicating: 


— those which are corrected in the source code 
delivered in the G-MEDIA 


— those which are not corrected in the source code 
delivered in the G-MEDIA 


If this parameter is given a value, the DETECT_SITE 
function is more complete and produces the list of 
patches, indicating: 


— those which are corrected in the source code 
delivered in the G-MEDIA 


— those which have an equivalent Patch delivered in 
the PATCH-MEDIA 


— those which have no equivalent Patch delivered in 
the PATCH-MEDIA 


DISPLAY If = 1, the messages of the DETECT_SITE function 
are displayed at the console. The default value is 0. 


Using CD-ROM on XTA Systems 


For XTA Systems, if the G-MEDIA is a CD-ROM, the image of GCOS 7 Technical 
Status must be transferred on a GCOS 7 Disk (in the file SYS.Gxxxx) by using a 
script located on the CD-ROM. 


Please read the installation instructions located on the CD-ROM in the file 
ReadMe _Install_updg components.txt. Details of this installation are documented 
in the paragraph "Using CD-ROM on XTA Systems" chapter 4.2.39. 


The file SYS.Gxxxx, containing an image of the GCOS 7 Technical Status, is used 
as input data, by the function DETECT_SITE. In this case INVOL1 must be given 
in the form Gxxxx:MS 
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For XTA Systems, if the PATCH-MEDIA is a CD-ROM, its contents must be 
transferred on a GCOS 7 Disk, in the file SYS.DTyww by using a script located on 
the CD-ROM. 


Please read the installation instructions located on the CD-ROM in the file 
ReadMe _Install_detect_site_tsu_components.txt. 


Execute the following installation instructions, to transfer the contents of the 
PATCH-MEDIA in the file SYS.DTyww: 


e Interop7 FTP servers must be started on Windows and GCOS 7 
e Launch a Windows “ Command Prompt ” session 
e Change your current directory for the CD-ROM directory 
e Issue the command: Install_Detect_SITE_TSU 
The following information are requested: 
- System Name: Windows name of the Diane System 


- Gcos Disk: Media name of a work disk for a SYS.DTyww file 
(media name without device type on which 70.000 
DBLKs free are necessary). The file SYS.DTyww will 
contain patch files. 


- Gcos user: Name of an user in project SYSADMIN, used to perform 
FTP transfer, from CD-ROM to GCOS 7 file 

- Password: GCOS 7 password of this user 

- FTP Port: FTP port number used to communicate with GCOS 7, 
usually 9037 


After this transfer on a GCOS 7 disk in the file SYS.DTyww, INVOL2 must be 
specified in the form: DIyww:MS. 


Because the files SYS.Gxxxx and SYS.DTyww are catalogued in the 
SYS.CATALOG of the running GCOS 7 System, the functions DETECT_SITE 
and UPDATE_GCOS must be performed from this current running Set. 


The file SYS.DTyww is deleted at the end of the DETECT_SITE function, so to 
execute again the DETECT SITE function, it is necessary to transfer again the 
PATCH-MEDIA content in the SYS.DTyww file using the 
Install_Detect_SITE_TSU script. The file SYS.Gxxxx is deleted only at the end of 
the UPDATE_GCOS function. 
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EXAMPLES: 


G: DTST INVOL1=G9920:MS INVOL2=DT451:MS; 


Environment 


The DETECT_SITE function requires a G-MEDIA and, optionally, a 
PATCH-MEDIA. 


The Set that is checked by DETECT_SITE is the running Set in a P2P 
configuration, and the P-Set in an RP configuration. 


The DETECT_SITE and UPDATE_GCOS function must be launched from the 
same running Set. 


If a P2P configuration is to be updated, it is assumed that the level of site patches is 
the same on both the P-Set and the P2-Set. 


Detailed purpose 


The JCL job IUF DETECT SITE 1s called from the G-MEDIA, if Technical Status 
is delivered on a set of tapes or cartridges, and from SYS.IUF of running system if 
Technical Status is delivered on CD-ROM (for XTA System only). 


The DETECT SITE function compares all site patches applied on customer sites 
with the software which is re-delivered with the new Technical Status, located on 
the G-MEDIA. These site patches may, or may not, be corrected in the new 
delivered Technical Status, or may have equivalent patches that are located in the 
PATCH-MEDIA (which may then be applied to the corresponding re-delivered 
software). 
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If any of these site patches, that are not corrected in the new Technical Status, have 
no applicable equivalent patches, a warning message is sent. The customer can 
therefore compare the software, analyze the differences, and decide for himself 
whether or not to apply the Technical Status. 


The applicable equivalent patches will be automatically applied during the 
application of the Technical Status by the UPDATE_GCOS function. 


EXAMPLES: 


G: DTST INVOL1=G99201/G99202:CT; 


Before the GCOS Domain is updated using the G-MEDIA "G99201/G99202:CT", 
this command will detect, on the running Set, which of the customer's site patches, 
that are applied on re-delivered software, are corrected or not in the new Technical 
Status. 


The customer's site patches and their status (corrected or not) are then 
listed. 


G: DTST INVOL1=G99201/G99202:CT INVOL2=PATCH:CT; 


Before the GCOS Domain is updated using the G-MEDIA "G99201/G99202:CT", 
this command will detect on the running Set and list, which of the customer's site 
patches, that are applied on re-delivered software: 


e are corrected or not in the G-MEDIA 
e have an equivalent site patch in the PATCH-MEDIA 
e have no equivalent site patch in the PATCH-MEDIA 


The equivalent site patches found in the PATCH-MEDIA "PATCH:CT" will be 
applied during the UPDATE _GCOS function. 


Q 
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The DISPLAY_RUNSET Function 


Purpose 


Returns a value (R, P, or P2) to indicate which is the running set. 


Syntax 


{DISPLAY_RUNSET | DRUNSET} [OUTAREA=char5] 


Parameter 

OUTAREA Optionally specifies the name of a global variable that 
you have previously declared to receive the value (R, 
P, or P2) indicating the running set. If this parameter is 
not present, the result is sent to the console screen. 

Environment 


This is a GCL procedure belonging to the domain H_NOCTX. It can either be 
activated in the system startup or be called by any operator or IOF user. 


Detailed purpose 


The GCL command DISPLAY _RUNSET enables the system administrator to start 
the system with automated operational conditions adapted to the running set. 


EXAMPLE: 


GB MYVAR LENGTH 5; 
DRUNSET OUTAREA=MYVAR ; 


After successful execution, the global variable MY VAR contains the value R, P, or 
P2 corresponding to the running set. If execution is unsuccessful, it contains the 
value ERROR. 


Q 
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EXAMPLE OF USE IN AN IOF USER STARTUP: 


GB MYVAR CHAR 5; 

DRUNSET OUTAREA=MYVAR ; 

AI TO=>RSET IF=#EQ (SMYVAR,R) ; 
AI TO=>PSET IF=#EQ (SMYVAR, P) ; 


AI TO=>P2SET 


IF=#EQ (SMYVAR, P2) ; 


SEND '>>>ERROR <<<<<'; 


AI TO=>END; 
SRSET: 
SEND '>>> 
AI TO=>END; 
SPSET: 
SEND '>>> 
AI TO=>END; 
SP2SET: 
SEND !>>> 
SEND: 
SEND !>>> 


Q 


RUNNING SET=R >>>'; 


RUNNING SET=P >>>'; 


RUNNING SET=P2 >>>'; 


END USER STARTUP >>>'; 
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4.2.23. The DISPLAY_STATUS Function 
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Purpose 


Displays the Technical Status of all the Domains installed on the target system Set, 
the location of all the system files, and the organization of the SET's volumes. 


Syntax 


{DISPLAY _STATUS|DSTAT} [SET={P|P2|R}] 


[{LIST_TS|LSTS}={1]|0}] 


[ {LIST_SYSFILES|LSF}={1|0}]; 


Parameters 

SET identifies which Set is to be the subject of the 
DISPLAY STATUS function. The default value is the 
running Set. 

LIST_TS if this is equal to 1, the Technical Status of all Domains 
is listed together with the SET's organization. 

LIST_SYSFILES if this is equal to 1, all the system files are listed with 
their MEDIA and DEVCLASS. 

Environment 


The running set may be the P-Set, P2-Set, or R-Set, as appropriate to the 
configuration concerned. 


The set whose status is to be displayed may be either the running set or the set 
currently linked to the running set. 


Detailed purpose 


The DISPLAY STATUS parameters are requested, if these have not already been 
supplied with the command. 


One or two lists are displayed, as selected by the function's parameters. 
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EXAMPLES: 


G: DSTAT SET=P; 


The current Technical Status is to be displayed, for all the file Domains present on 
the system, based on the P-Set, together with the P-Set's organization. 


G: DSTAT; 


The current Technical Status is to be displayed, for all the Domains present on the 
system, based on the running SET, together with the organization concerned. 


G: DSTAT LIST_SYSFILES=1 SET=P2; 


System file media and devclass are to be displayed for all the system file Domains 
on the P2-Set together with the current Technical Status. 


Q 
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4.2.24 The EDIT Function 


Purpose 


Calls the Text Editor. 


Syntax 


{EDIT|ED} [LIB=1ib78] 


[ {COMFILE|CMDF}=file78]; 


Parameters 

LIB identifies the SL library to be used as the output 
library. 

COMFILE names the file containing the EDIT commands to be 
executed. (The COMFILE parameter is mandatory in 
batch mode.) 

Environment 


The running set may be the P-Set, P2-Set, or R-Set. 


The accessible SL libraries are those cataloged in the running SYS.CATALOG and 
in the running SITE.CATALOG. 


Detailed purpose 


EDIT allows you to create and modify the contents of SL library members. The 
Text Editor is described in the Text Editor User's Guide. 


EDIT requests the Text Editor parameters, if not already supplied with the 
command. 


Ifa LIB is: 


e supplied, the EDIT processor assigns the specified library. 

e not supplied, the EDIT processor assigns the SL library whose description is 
contained in the system variable #SLIB. (#SLIB may be set and modified by the 
MWLIB command before the GIUF processor is called.) If #SLIB has not been 
set, a temporary SL library (TEMP.SLLIB$TEMPRY) is used. 
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Ifa COMFILE is: 


e supplied, the EDIT processor will process the commands it contains. 
e not supplied, the EDIT processor is started in interactive mode. 


EXAMPLES: 


G: EDIT; 
Call the Text Editor. Use a default library. 


G: EDIT LIB=P1.SLO01; 


Call the Text Editor. Use the cataloged library named P1.SLO01. 


G: EDIT LIB=MINE:P2V9:MS/FSA COMFILE=OURS..SF1SRES; 


Call the Text Editor. Use as output library the uncataloged SL library named 
MINE which resides on the MS/FSA volume named P2V9. Process the commands 
contained in subfile SF1 located in the uncataloged library named OURS which 
resides on a resident volume. 


Q 
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The FSE Function 


Purpose 


Calls the Full Screen Editor. 


Syntax 

{FSE} [LIB=1ib78] 

Parameters 

LIB identifies the SL library to be used as the output 
library. 

Environment 


The running set may be the P-Set, P2-Set, or R-Set. 
This command cannot be used in batch mode. 


If the used terminal does not have full screen facilities, use Text Editor (which is 
called by the EDIT command). 


The accessible SL libraries are those cataloged in the running SYS.CATALOG and 
in the running SITE.CATALOG. 
Detailed purpose 


FSE allows you to create, modify, and delete SL library members. The Full Screen 
Editor is described in the Full Screen Editor User's Guide. 


FSE requests the Full Screen Editor parameters, if not already supplied with the 
command. 
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Ifa LIB is: 


e supplied, the FSE processor assigns the specified library. 

e not supplied, the FSE processor assigns the SL library whose description is 
contained in the system variable #SLIB. (#SLIB may be set and modified by the 
MWLIB command before the GIUF processor is called.) If #SLIB has not been 
set, a temporary SL library (TEMP.SLLIB$TEMPRY) is used. 


EXAMPLES: 


G: FSE; 


Call the Full Screen Editor. Use a default library. 


G: FSE LIB=P1.SL01; 


Call the Full Screen Editor. Use the cataloged library named P1.SLO1. 
QO 
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4.2.26 The LEVEL Function 
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Purpose 


Correctable system files in the P-Set, or in the R-Set, are updated from either the 
P-Set, or the P2-Set, or vice versa. 


Syntax 


{LEVEL |LV} INSET={P|P2|R} OUTSET={P|P2|R} 


[{DOMAIN|DOM}={ ALL |FW|DSA|OLTD|GCOS|GSF}]; 


Parameters 

INSET identifies the input set. 

OUTSET identifies the Set to be updated. 

DOMAIN identifies the Domain whose files are to be updated: 
ALL (the default value) - all Domains will be updated. 
GCOS - the GCOS Domain is to be updated. 
OLTD - the OLTD Domain is to be updated. 
DSA - the DSA Domain will be updated. 
FW - the Firmware Domain is to be updated. 
GSF - the GCOS 7 Service Facility Domain is to be 
updated. 

Environment 


This function may only be submitted under the SYSADMIN project, and not in a 
PO configuration where, if it is attempted, the following message is sent: 


FUNCTION NOT ALLOWED IN A PO CONFIGURATION 


The running Set may be the P-Set, P2-Set, or R-Set. However, if only one Set has 
its access rights validated, that Set must be the running Set. 


When MI configurations differ between the input and output SYS.SYSTEM files, 
the running disk must be the output system disk. 
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After performing LEVEL between Sets belonging to two different systems, a 
CONFIG is required on the output Set. 


If the output Set is already, or is to become, the running Set, an ISL RESTORE 
session must be run. 


Refer to the "Important Note" in the paragraph GCOS 7 Updating Procedure in 
Chapter 7 "Updating Domains". 


Detailed purpose 


Requests the LEVEL parameters, if these are not supplied. Displays the 
consequences for the updated Set. These consequences consist of an upgrading or 
a downgrading of the specified Domains according to the Technical Status applied 
to them. This function checks the type of configuration involved and calls the 
IUF_LEVEL JCL, which updates one or more Domains of a Set, as follows: 


e When MI configuration codes are equal: 


— Duplication of the specified Domain files. (The Firmware Domain is copied 
when FW Releases are the same.) 
— The MI configuration is copied from the input to the output Sets. 


e When the MI configuration codes are different: 
— Duplication of the specified Domain files. (The Firmware Domain is copied 
when FW Releases are the same.) 
— Restores the MI configuration from memory to the output SYS.SYSTEM. 
EXAMPLE: 
G: LV INSET=P OUTSET=P2; 


All system files in the P2-Set are to be updated, based on the P-Set. 


Q 
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4.2.27. The LEVEL _MI Function 
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Purpose 


When the MI configuration is updated on a Set of system disks (P-Set, P2-Set, or 
R-Set), for example after ADD_MI or DELETE_MI, the non-updated Set may be 
updated with the new MI configuration using LEVEL_MI. 


LEVEL MI is mandatory after UPDATE_MI. 


Syntax 


{LEVEL_MI|LEVMI} INSET={P|P2|R} OUTSET={P|P2|R}; 


Parameters 

INSET identifies the input Set. 
OUTSET identifies the output Set. 
Environment 


The running Set may be the P-Set, P2-Set, or R-Set. 


LEVEL MI is applicable only in a P2P- or an RP configuration. If attempted in a 
PO configuration, the following message is sent: 


"FUNCTION NOT ALLOWED IN A PO CONFIGURATION" 


If the output Set is already, or is to become, the running Set, an ISL RESTORE 
session must be run. 


When execution is completed, a warning message is displayed on the console and 
written in the JOR: 


* AN ISL RESTORE SESSION IS NECESSARY ON THE OUTPUT SET 
* IF THIS SET IS ALREADY OR IS TO BECOME THE RUNNING SET. 


EXAMPLE: 


G: LEVMI INSET=P2 OUTSET=P; 


This example concerms a P2P configuration. The MI configuration in the P-Set is 
to be updated from that in P2-Set. 


Q 


4-65 


GCOS 7 System Installation Configuration and Updating Guide 


4.2.28 The LIST_MI Function 


Purpose 


Lists from memory, or from the SYS.SYSTEM file, the MI configuration code, the 
hardware model number, CPU number and the MIs. For each MI, this function 
lists the relevant: 


e Product name 
e Installation date 
e Expiry date, if any. 


Syntax 


{LIST_MI|LSMI} [SET={P|P2|R}] [{INPUT|IN}={MEM |SyYS}] 


[ {DISPLAY |D}={1]|0}]; 


Parameters 

SET designates the Set from which the list is to be 
displayed. The default value is the running Set. 

INPUT designates the origin of the list; 1.e., either memory or 
SYS.SYSTEM. The parameter INPUT=MEM is valid 
only for a running Set. 

DISPLAY if 0 (the default value), output is directed to SYS.OUT; 


if 1, the output is displayed at the terminal as well. 
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Environment 

The running Set may be a P-Set, a P2-Set, or an R-Set. 

The Set to be listed must be the running Set, or a Set linked to it. 
EXAMPLES: 

G: LSMI SET=P2; 


Information on the MI's of the running P2-Set is to be listed from memory, for 
delivery only to SYS.OUT. 


G: LSMT; 


Based on the running Set, MI information is to be delivered from memory to 
SYS.OUT for display. 


G: LSMI SET=P IN=SYS D=1; 


Based on the P-Set, MI information is to be displayed from the SYS.SYSTEM file, 
both at the requesting terminal and via SYS.OUT. 


Q 
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4.2.29 The MODIFY_CONF Function 


Purpose 


Allows the user to move from a P2P- or an RP configuration, to a PO 
configuration, and vice versa. 


Syntax 


{MODIFY_CONF|MDC} {CURCONF |CCONF}={PO|P2P|RP} 


{NEW_CONF | NCONF}={PO|P2P|RP}; 


When CURCONF=PO and NEWCONF=RP: 


{RSET_NAME | RSET}=media:devclass; 


When CURCONF=PO and NEWCONF=P2P: 


{P2SET_NAME | P2SET}=media:devclass; 


Parameters 

CURCONF defines the current configuration. 

NEWCONF defines the new configuration. 

RSET NAME specifies the new R-Set's MEDIA name and 
DEVCLASS, for linking to the running P-Set in order 
to pass from a PO configuration to an RP 
configuration. 

P2SET_ NAME specifies the new P2-Set's MEDIA name and 


DEVCLASS, for linking to the running P-Set in order 
to pass from a PO configuration to a P2P 
configuration. 
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Environment 
The running Set must be a P-Set (PO or P2P). 


If the current configuration is PO, the (P2-, or R-) Set to be linked to the P-Set (in 
order to change configuration) must have already been built by: 


e The IUF function BUILDP2, or the IUF function SAVE_ SET followed by 
INSTAL _PSET, if a P2-Set. 


e The IUF function SAVE SET followed by INSTAL_RSET, if an R-Set 


Detailed purpose 


The MODIFY_CONMF parameters are requested interactively, if these have not 
already been supplied. 


This function updates the IUF_CONFSET member of the SYS.IUF library in both 
Sets in the system with the following parameters, as appropriate: 


e CONF 

e RSETMD, RSETDVC 
e PSETMD, PSETDVC 

e P2SETMD, P2SETDVC. 


EXAMPLE: 


G: MODIFY_CONF CURCONF=RP NEWCONF=PO; 


The system concermed is to be modified from an RP configuration to a PO 
configuration. 


G: MODIFY_CONF CURCONF=PO NEWCONF=RP RSET _NAME= 
RSETA:MS/FSA; 


An existing PO configuration is to become an RP configuration. The R-Set, 
located on MS/FSA disk RSETA, is to be linked to the P-Set. 


G: MODIFY_CONF CURCONF=PO NEWCONF=P2P P2SET_NAME= 
P2SETA:MS/FSA; 


An existing PO configuration is to become a P2P configuration. The P2-Set, 
located on MS/FSA disk P2SETA, is to be linked to the P-Set. 


Q 
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4.2.30 The PATCH_HLMLIB Function 


Purpose 


Patching of the SYS.HLMLIB file. 


Syntax 


{PATCH_HLMLIB|PATLM} [SET={P|P2|R}] 


[ {COMPILE | CMDF}=file78 
[{PRIFILE|PRTF}=file78]]; 


Parameters 

SET identifies the Set to be patched. The default value is 
the running Set. 

COMFILE names the file containing the LIBMAINT LM 
commands to be executed. 

PRTFILE names a private print file to contain the LIBMAINT 
LM report. The default value is: 
— The console, in IOF mode 
— SYS.OUT, in EJ mode. 

Environment 


The running Set may be the P-Set, the P2-Set, or the R-Set. 


In IOF mode, this function must be submitted by a user whose profile has been set 
with the parameter NOVICE = 0. 


If the Load Modules to be patched have been preinitialized, they must first be 
cleared from Backing Store (see the chapter Patching Procedures). 
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Detailed purpose 


Requests the PATCH_HLMLIB parameters, if not already supplied with the 
command. 


Ifa COMFILE is: 


e Supplied, the LIBMAINT LM processor will process the commands it contains. 


e Not supplied, the LIBMAINT LM processor is launched in interactive mode. 
Any LIBMAINT LM command may be used, except MODIFY with the TS 
parameter. 


EXAMPLES: 


G: PATLM COMFILE=LIB..SF SET=P; 


Corrections made with the LIBMAINT LM commands, contained in the library 
LIB subfile SF, are to be applied as patches to the SYS.HLMLIB file in the P-Set. 


G: PATLM COMFILE=LIB..SF1:VOL1:MS/FSA SET=P2; 


Corrections made with the LIBMAINT LM commands, contained in subfile SF1 of 
library LIB, are to be applied as patches to the SYS.HLMLIB in the P2-Set. 


Q 
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4.2.31 The PATCH_SYSTEM Function 


Purpose 


Patching of the SYS.SYSTEM file. 


Syntax 


{PATCH_SYSTEM|PATSYS} [SET={P|P2|R}] 


[ {COMFILE | CMDF}=file78 
[{PRIFILE|PRTF}=file78]]; 


Parameters 

SET identifies the Set to be patched - by default the running 
Set. 

COMFILE names the file containing the MAINTAIN SYSTEM 
commands to be executed. 

PRTFILE names a private print file to contain the 
MAINTAIN SYSTEM report. The default value is: 
— The console, in IOF mode 
— SYS.OUT, in EJ mode. 

Environment 


The running Set may be the P-Set, the P2-Set, or the R-Set. 


In IOF mode, this function must be submitted by a user whose profile has been set 
with the parameter NOVICE = 0. 


If the output Set is already, or is to become, the running Set, an ISL RESTORE 
session must be run in order to validate the patch(es) just applied (see the chapter 
Patching Procedures). 
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Detailed purpose 


Requests the PATCH SYSTEM parameters, if these have not been supplied with 
the command. If the COMFILE 1s: 


e Supplied, the MAINTAIN SYSTEM processor will process the commands it 
contains. 


e Not supplied, the MAINTAIN SYSTEM processor is launched in interactive 
mode; any MAINTAIN SYSTEM commands may be used except MODIFY 
with the TS parameter. 

EXAMPLES: 


G: PATSYS SET=P COMFILE=LIB. .SF; 


MAINTAIN SYSTEM commands and patches contained in subfile SF of the 
resident library LIB, are applied to the SYS.SYSTEM file in the P-Set. 


Q 


4-73 


GCOS 7 System Installation Configuration and Updating Guide 


4.2.32 


4-74 


The PROTECT_GCOS Function 


Purpose 


This function may be used for updating the system files' access right list in the 
SYS.CATALOG on the running system disk. 


For a list of the access rights set by PROTECT_GCOS, refer to the table A-8 
System File Access Rights at the end of the Appendix System File Descriptions. 
Refer also to the Appendix Maintenance in a Protected Environment. 


Syntax 


{PROTECT_GCOS | PROG} {ACCESS_RIGHT|ACCR}={SET|RESET}; 


Parameters 

ACCESS _ RIGHT determines whether the access rights list is to be SET 
or RESET, for all objects in the running 
SYS.CATALOG. 

Environment 


Access rights (if any) must have been initialized in the running SITE.CATALOG 
by the system administrator, with at least the following three GCL commands: 


MDACL * PROJECT=S YSADMIN/OWNER 
MDACL SITE TYPE=DIR PROJECT=SYSADMIN/OWNER 
MDACL SITE.CATALOG PROJECT=*/WRITE 


Once the access rights have been completely installed and before starting normal 
production, the system administrator should, for example, use MDACL on the 
SITE.STARTUP and SITE.HELP files with READ=*, as follows: 


MDACL SITE.STARTUP PROJECT=*/READ 
MDACL SITE.HELP PROJECT=*/READ 


in order for all users to be able to make use of these files. 
For a detailed description of catalog object protection, refer to the Data Security 
Manual and to the Catalog Management User's Guide. 


The projects OPERATOR and RMSIOF must be present in the SITE.CATALOG. 
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This function must be submitted under the SYSADMIN project, and never while 
TDS is active. This is because TDS requires exclusive access to the 
SYS.HBINLIB file, which means that PROTECT GCOS would be placed 
indefinite in the state "WAITS FOR FILE" with respect to SYS.HBINLIB. 


Detailed purpose 


This function requests the PROTECT_GCOS parameter, if this has not already 
been submitted with the command. 


It checks that SYSADMIN is owner of the SITE.CATALOG, and then creates the 
IUF_OPT_FILE member in the SYS.IUF library for use by the JCL: 


e Calls the [UF_PROTGCOS JCL in the SYS.IUF library 
e Sets (or resets, as requested) the access rights in the running SYS.CATALOG. 
e Deletes the [UF_OPT_FILE member in the SYS.IUF library. 


EXAMPLES: 
G: PROG ACCESS_RIGHT=SET; 
Access rights are to be set in the SYS.CATALOG on the running system disk. 


G: PROG ACCESS_RIGHT=RESET; 


Access rights are deleted in the SYS.CATALOG of the running set. 
Q 


IMPORTANT: 
To delete access rights in the SITE.CATALOG, the system administrator must 
execute the following GCL command: 


J) 


MDACL *, TYPE=DIR, DELETE=SYSADMIN, CATNAME=SITE 
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4.2.33. The RESTORE_SET Function 


Purpose 


Correctable system files are restored from the multivolume SET-MEDIA created 
by the SAVE_SET function. The functions SAVE_SET plus RESTORE_SET are 
equivalent to the LEVEL function. 


This facility is mainly used in a multi-system environment, to update a slave P-Set, 
or P2-Set. It may also be used instead of the LEVEL function to restore a previous 
TS level from the SET-MEDIA. 


Syntax 


{RESTORE_SET|RSTSET} INVOL=media:devclass OUTSET={P|P2|R} 


Parameters 


INVOL 


OUTSET 
SITE 


DOMAIN 
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[ {DOMAIN | DOM} ={ALL|GCOS | OLTD| FW|DSA|GSF}] 


[SITE={1|0}]; 


identifies the media name(s) and devclass of the 
SET-MEDIA. 


names the Set to be updated. 


= | triggers the extraction of any site patches from the 
Set to be modified, followed by their reapplication 
after completion of the restore. 


identifies the Domain to be updated: 


ALL (the default value) - all the Domains will be 
updated. 


GCOS - the GCOS Domain will be updated. 
OLTD - the OLTD Domain will be updated. 
DSA - the DSA Domain will be updated. 

FW - the FIRMWARE Domain will be updated. 


GSF - the GCOS 7 Service Facility Domain will be 
updated. 
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Environment 
This function may be submitted only under the SYSADMIN project. 


The Set to be updated may be multivolume, and may be the P-Set, P2-Set, or 
R-Set, as appropriate. 


The running Set may be the P-Set, P2-Set, or R-Set. 


Detailed purpose 


Requests the RESTORE _ SET parameters, if these have not already been supplied 
with the command. 


Reads the SET.STATUS file from the SET-MEDIA; refer to the description of this 
file for the SAVE_SET function later in this chapter. 


Comparison is made between input and output TSNs, for the Domain(s) to be 
updated. 


The following are displayed: 

e For the original saved Set: Set type, MEDIA, DEVCLASS. 
e For the updated Set: Set type, MEDIA, DEVCLASS. 

e The TSNs for both Sets relevant to the Domains updated. 


e The consequences for the updated Set: these represent either an upgrading or a 
downgrading of the specified Domains, according to the Technical Status applied 
to them. 


The user's agreement is requested on the above displayed data, and then: 


e The contents of the updated Domain files are restored with the FILREST utility. 
(The Firmware Domain is copied when FW Releases are the same). 


e The MI configuration is restored to the SYS.SYSTEM file from Memory. 


If SITE = 1, site patches are retrieved from the updated Set before the restore is 
performed, and reapplied to the updated Set after the restore has been completed. 


The CONFIG job executes with the last user COMFILE saved in the 
LAST CONFIG INPUT member in the SYS.IUF library. 


EXAMPLE: 
G: RSTSET INVOL=abcD51/abcD52/abcD53:CT OUTSET=P DOM=GCOS; 


All the correctable GCOS 7 files are to be restored to the P-Set from the 
SET-MEDIA, located on the tapes abcD51, abcD52 and abcDS53. 


Q 
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4.2.34 The RESTORE_SITE Function 


Purpose 


The system files SYS.SITE.SL and/or SYS.SITE.BIN is/are restored from 
tape/cartridge to the Set designated. 


Syntax 


Fd 


{RESTORE_SITE|RSTS} {FILE|F}={SYS.SITE.SL|SYS.ST' 


E.BIN| BOTH} 


INVOL=media:devclass OUTSET={P|P2|R}; 


Parameters 

FILE identifies the files to be restored. When FILE = 
BOTH, the files SYS.SITE.SL and SYS.SITE.BIN are 
both restored. 

INVOL identifies the media name(s) and devclass of the Set 
tape/cartridge volumes. 

OUTSET names the Set to be updated. 

Environment 


The Set to be updated may be multivolume, and may be the P-Set, P2-Set, or 
R-Set, as appropriate. 


The running Set may be the P-Set, P2-Set, or R-Set. 
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Detailed purpose 


Requests the RESTORE SITE parameters, if these have not already been supplied 
with the command. 


The JCL IUF_RST_SITE is called. 


According to the value of the parameter FILE, the SYS.SITE.SL file and/or the 
SYS.SITE.BIN file is/are restored from tape/cartridge via the FILREST utility to 
the Set designated. 


EXAMPLES: 


G: RSTS FILE=BOTH INVOL=abc:CT OUTSET=P; 


The SYS.SITE.SL and SYS.SITE.BIN files are both to be restored from tape media 
name "abc" to the P-Set. 


Q 
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4.2.35 
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The RESTORE_SITEFILES Function 


Purpose 


Restores the contents of a site file (SITE.CATALOG, SITE.HELP, SITE.STARTUP, 
SYS.URCINIT, SYS.SITE.SL, SYS.SITE.BIN, SYS.DSACONF, 
SYS.DSACORE) from tape/cartridge to the Set designated. 


Syntax 
{RESTORE _SITEFILES RSTSITE} {FILE | F}=char12 
INVOL=media:devclass 


OUTVOL=media:devclass; 


When FILE=SITE.CATALOG: 
[ {CATBUILD | CATB}={0|1}] 


[ {OUT_ACCRIGHT | OUTACCR}={0]|1}] 


[ {RUN_ACCRIGHT | RUNACCR}={0|1}] 

[ {RUN_OUTPUT | RUNOUT}={0|1}1; 
When CATBUILD=1: 

[ {NBOBJ=dec5}]; 


The RUN_OUTPUT parameter is required. 


When FILE=SITE.STARTUP: 
[ {PREALLOC | PALC}={0|1}] 
[ {STUP_OUTVOL | STUPOV}=media:devclass] 


[ {OUT_ACCRIGHT | OUTACCR}={0|1 


w 


] 


[ {RUN_ACCRIGHT | RUNACCR}={0|1 


we 


dhs 
When PREALLOC=1: 


[{SIZE|SZ}=dec8] ; 
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When FILE=SITE.HELP: 
[ {PREALLOC | PALC}={0|1}] 
[ {HELP_OUTVOL | HELPOV}=media:devclass] 


[ {OUT_ACCRIGHT | OUTACCR}={0|1 


Ww 


] 


[ {RUN_ACCRIGHT | RUNACCR}={0|1 


w 


ae 
When PREALLOC=1: 


[{SIZE|SZ}=dec8] ; 


When FILE=SYS.URCINIT or SYS.SITE.SL or SYS.SITE.BIN: 
[ {PREALLOC | PALC}={0|1}] 
When PREALLOC=1: 


[{SIZE|SZ}=dec8] ; 


When FILE=SYS.DSACONF or SYS.DSACORE 
[ {PREALLOC | PALC}={0|1}] 

[ {DSA_OUTVOL | DSAOV}=media:devclass] 
When PREALLOC=1: 


[{SIZE|SZ}=dec8] ; 


Parameters 

FILE names the file to be restored. This must be 
SYS.URCINIT, SITE.CATALOG, SITE.STARTUP, 
SITE.HELP, SYS.SITE.SL, SYS.SITE.BIN, 
SYS.DSACOMF, or SYS.DSACORE 

INVOL identifies the media name(s) and devclass of the Set 


tape/cartridge volumes. 
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OUTVOL 


identifies the media name and devclass of the output 
volume containing: 


— SITE.CATALOG, when FILE = 
{SITE.CATALOG|SITE.STARTUP|SITE.HELP} 


— SYS.CATALOG, when FILE = 
{SYS.URCINIT|SYS.SITE.SL|SYS.SITE.BIN 
ISYS.DSACONF|SYS.DSACORE} 


When FILE = SITE.CATALOG: 


CATBUILD 


OUT_ACCRIGHT 


RUN_ACCRIGHT 


RUN_OUTPUT 


NBOBJ 


if 1, any existing SITE.CATALOG is deleted from the 
OUTVOL and a new one built. The output 
SITE.CATALOG must not be the running one. 


= | when access rights are set on the output 
SITE.CATALOG 


= | when access rights are set on the running 
SITE.CATALOG 


= 1 if the output Set is the running Set. This parameter 
must be specified in agreement with the OUTVOL 
parameter. RUN OUTPUT must be specified 
explicitly as either 1 or 0, if both OUT _ACCRIGHT = 
1 and RUN ACCRIGHT = 0 are defined; as 0 if 
CATBUILD = 1 is defined. In all other cases, the 
value of 0 is applied. 


defines the approximate maximum number of objects 
to be accommodated in the SITE.CATALOG to be 
built. 


When FILE = SITE.STARTUP: 


PREALLOC 


STUP_OUTVOL 


SIZE 
OUT_ACCRIGHT 


RUN_ACCRIGHT 


if 1, space is allocated for a SITE.STARTUP file on the 
volume named by STUP_OUTVOL. 


identifies the media name and devclass of the volume 
to contain the new SITE.STARTUP file. 


defines the size of the new SITE.STARTUP file. 


= | when access rights are set on the output 
SITE.CATALOG 


= | when access rights are set on the running 
SITE.CATALOG. 
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When FILE = SITE.HELP: 


PREALLOC if 1, space is allocated for a SITE.HELP file on the 
volume named by HELP_OUTVOL 

HELP_OUTVOL identifies the media name and devclass of the volume 
to contain the new SITE.HELP file. 

SIZE defines the size of the new SITE.HELP file. 

OUT_ACCRIGHT = | when access rights are set on the output 
SITE.CATALOG 

RUN_ACCRIGHT = | when access rights are set on the running 
SITE.CATALOG. 


When FILE = SYS.URCINIT or SYS.SITE.SL or SYS.SITE.BIN: 


PREALLOC if 1, space is allocated fora SYS.URCINIT or 
SYS.SITE.SL or SYS.SITE.BIN file on the volume 
named by OUTVOL 

SIZE defines the size of the new SYS.URCINIT or 


SYS.SITE.SL or SYS.SITE.BIN file. 
When FILE = SYS.DSACONF or SYS.DSACORE: 


PREALLOC if 1, space is allocated fora SYS.DSACONF or 
SYS.DSACORE file on the volume named by 
DSA_OUTVOL 

DSA_OUTVOL identifies the media name and devclass of the volume 


to contain the new SYS.DSACOMF or 
SYS.DSACORE file. This volume must be in FBO 
organization. 


SIZE defines the size of the new SYS.DSACONF or 
SYS.DSACORE file. 
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Environment 
The running Set may be the P-Set, P2-Set, or R-Set. 


The input volume on which the file is saved (see SAVE_SITEFILES) and the 
output volume to which the file is restored may be both of the same type and 
organization or each of a different type and organization. 


Files may be restored using the RESTORE_SITEFILES function: 
From an FBO site to another FBO site 


From an VBO site to an FBO site, except for the SYS.URCINIT file for 
which user options must be generated again by a $URINIT JCL step. 


However, they cannot be copied from an FBO site to a VBO site. 


A Migration Tool is available for transferring files from an FBO site to a VBO 
site. File migration can take place on the same site, or from one site to another. 
The Migration Tool is reserved for users logged on under the SYSADMIN project, 
and is called by the GCL command MNMIG. For more information, refer to the 
File Migration Tool User's Guide. 


If SYS.URCINIT is restored with preallocation, an ISL RESTART (WARM) 
session must be run. 


The user must be logged on under the SYSADMIN project, in order to be able to 
restore the SITE.CATALOG. 


The running SITE.CATALOG cannot be deleted and rebuilt (by specifying 
CATBUILD = 1 when RUN OUTPUT = 1). 


When the input SITE.CATALOG has its access rights validated: 


e The output SITE.CATALOG will also have its access rights validated; note that 
private catalogs' access rights (together with their master directories in the 
SITE.CATALOG) cannot be moved unless all the objects concerned have the 
appropriate access rights in the output SITE.CATALOG as well. The easiest 
way to move master directories together with the corresponding private 
catalog access rights, is to rebuild the new SITE.CATALOG (by specifying 
CATBUILD = 1). 


e Ifthe disk supporting the output SITE.CATALOG is not the running disk, the 
running disk's access rights are temporarily validated for the duration of the job's 
execution. 
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When a new SITE.CATALOG file is built in output, the following files must be 
cataloged in the new SITE.CATALOG: 


SITE.STARTUP 

SITE.HELP 

SITE.IN 

and, when they exist, the SITE.CMS *, SITE.HALOCK and SITE.MIRLOG 
files. 


The SITE.STARTUP and SITE.HELP input files must both be cataloged. 


Detailed purpose 


This function requests the RESTORE SITEFILES parameters, if these have not 
already been supplied with the command. 


The following files may be copied: 


SYS.URCINIT SITE.CATALOG 
SYS.SITE.BIN SITE.HELP 
SYS.SITE.SL SITE.STARTUP 
SYS.DSACONF SYS.DSACORE 


The RESTORE _SITEFILES function calls the JCL, as appropriate, for one of the 
following: 


IUF_CATREST, which uses: 


- the FILREST utility to restore the SITE.CATALOG file when the INVOL 
and OUTVOL organizations are the same 


- the CREATE processor to restore the SITE.CATALOG file when INVOL 
is VBO and OUTVOL is FBO. 


IUF_STPRST, which uses the LIBMAINT processor to move the 
SITE.STARTUP file 


IUF_HELPRST, which uses the LIBMAINT processor to move the 
SITE.HELP file 


IUF_URCRST, which uses the FILREST processor to restore the 
SYS.URCINIT file 


IUF_DSARST, which uses the LIBMAINT processor to move the 
SYS.DSACONF and SYS.DSACORE files 


IUF_SITERST, which uses the LIBMAINT processor to move the 
SYS.SITE.SL and SYS.SITE.BIN files. 
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EXAMPLES: 


G: RSTSITE FILE=SITE.CATALOG INVOL=SAV1V9:CT 
OUTVOL=P2V9 :MS/FSA; 


The SITE.CATALOG file is to be restored from the tape designated by 
"SAV1V9:CT" to the Set designated by "P2V9:MS/FSA". 


G: RSTSITE FILE=SITE.STARTUP INVOL=SAV1V9:CT 
OUTVOL=P2V9 :MS/FSA; 


The SITE.STARTUP file is to be restored from the tape designated by 
"SAV1V9:CT" to the Set designated by "P2V9:MS/FSA". 


G: RST_SITEFILES FILE=SYS.URCINIT INVOL=SAV1V9:CT 
OUTVOL=P2V9 :MS/FSA; 


The SYS.URCINIT file is to be restored from the tape designated by 
"SAV1V9:CT" to the Set designated by "P2V9:MS/FSA". 


G: RSTSITE FILE=SYS.DSACONF INVOL=SAV1V9:CT 
OUTVOL=P2V9 :MS/FSA; 


The SYS.DSACOMF file is to be restored from the tape designated by 
"SAV1V9:CT" to the Set designated by "P2V9:MS/FSA". 


Q 
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The SAVE_SET Function 


Purpose 


Correctable system files relevant to all Domains (GCOS, FW, OLTD, GSF and 
DSA), or to a specified Domain , are saved from a P-Set, a P2-Set, or an R-Set, toa 
multivolume tape/cartridge called SET-MEDIA. 


If all the GCOS7 Domains are saved, the INSTAL RSET and INSTAL PSET jobs 
are created on the SET-MEDIA. 


When all the Domains are saved, the SET-MEDIA may be used for installing a 
Slave R-Set with the INSTAL_RSET job, a Slave P-Set with the INSTAL PSET 
job, or for updating a Slave Set with the IUF function RESTORE SET. 

The functions SAVE_SET plus RESTORE SET are equivalent to the LEVEL 
function. 


Syntax 


{SAVE_SET|SVSET} INSET={P|P2|R} {OUTDVCLASS|OUTDVC}=devclass 


{PREFIX|TPPFX}=char5 [{DOMAIN|DOM}={ALL|GCOS|OLTD|FW|DSA|GSF}] ; 


Parameters 
INSET identifies the Set to be saved to the SET-MEDIA. 


PREFIX defines the prefix to be used for generating SET- 
MEDIA names, as follows: 


abcdex, where: 


abcde = SET-MEDIA prefix (in alphanumeric 
characters) 

x = SET-MEDIA sequence number 

x is automatically generated by the SAVE_SET. 


For example: 
ABCDE1, ABCDE2, ... or 123451, 123452, ... 
OUTDVCLASS identifies the device class of the SET-MEDIA. 
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DOMAIN identifies the Domain to be saved. 


ALL (the default value)- all the Domains will be saved. 
GCOS - the GCOS Domain will be saved. 
FW - the FW Domain will be saved. 
OLTD - the OLTD Domain will be saved. 
GSF - the GSF Domain will be saved. 
DSA - the DSA Domain will be saved. 


Environment 


The Set to be saved may be multivolume, and may be the running Set. The 
SET-MEDIA must have been prepared in advance. 


Detailed purpose 


This function requests the SAVE_SET parameters, if these have not already been 
supplied with the command. It creates the SYS.IUF file which contains 
information about the saved Set, and also calls the JCL contained in the 
IUF_SET_ STATUS subfile. 


The SET.STATUS sequential file is created on the SET-MEDIA. 


Correctable files are saved from all Domains or from a specified Domain, mostly 
via the FILSAVE utility (SYS.GSF.UFAS is in fact saved via CREATE, and 
SYS.SYSTEM is saved via MAINTAIN SYSTEM), including: 


e GCOS 7 files. 
e OLTD files. 

e FW files. 

e GSF files. 

e DSA files. 
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Description of the SET.STATUS file: 
The file content is a concatenation of the subfiles: 


SYS.IUF..IUF_SET_STATUS 
SYS.IUF..IUF_MICONF 


EXAMPLES: 


G: SVSET INSET=P PREFIX=abcde OUTDVCLASS=CT; 


The contents of the P-Set are to be saved to a SET-MEDIA multi-volume tape file. 
SET-MEDIA is to be located on magnetic tapes whose names are each to be 
prefixed with "abcde". 


Q 
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The SAVE_SITE Function 


Purpose 


The system files SYS.SITE.SL and/or SYS.SITE.BIN is/are saved to tape/cartridge 


from the Set designated. 


Syntax 


{SAVE_SITE|SVS} {FIL 


E|F}={SYS.SITE.SL|SYS.SITE.BIN| BOTH} 


INSET={P|P2|R} 


{OUTDVCLASS | OUTDVC}=<tape-dvc> 


PREF IX=char3 ; 


Parameters 


FILE 


INSET 
OUTDVCLASS 


PREFIX 


Environment 


identifies the files to be saved. When FILE = BOTH, 
the files SYS.SITE.SL and SYS.SITE.BIN are both 
saved. 


names the Set to be saved. 


specifies the devclass of the Set tape/cartridge 
volumes. See the Preface for the full syntax of device 
specification. 


defines the 3 character prefix to be used in the MEDIA 
name of the output tape/cartridge, as follows: 


abc 


where abc represents the tape/cartridge prefix defined 
with this parameter. 


The Set to be saved may be multivolume, but must be the running Set. 


The tape/cartridge must have been prepared in advance, using the GCL procedure 
PREPARE TAPE or the VOLPREP utility. 
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Detailed purpose 


Requests the SAVE_SITE parameters, if these have not already been supplied with 
the command. 


The JCL IUF_SAVE SITE is called. 


According to the value of the parameter FILE, the SYS.SITE.SL file and/or the 
SYS.SITE.BIN file is/are saved to tape/cartridge via the FILSAVE utility from the 
Set designated. 


EXAMPLE: 


G: SVS FILE=BOTH INSET=P OUTDVC=CT PREFIX=abc 


The SYS.SITE.SL and SYS.SITE.BIN files are both to be saved to tape/cartridge 
media "abc" from the P-Set. 


Q 
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The SAVE_SITEFILES Function 


Purpose 


Saves the contents of a site file (SITE.CATALOG, SITE.HELP, SITE.STARTUP, 
SYS.URCINIT, SYS.SITE.SL, SYS.SITE.BIN, SYS.DSACONF, 
SYS.DSACORE) from the Set designated to tape or cartridge. 


Syntax 


{SAVE_SITEFILES|SVSITE} {FILE|F}=char12 INVOL=media:devclass 


OUTVOL=media:devclass; 


When FILE = SYS.URCINIT, SYS.SITE.SL, SYS.SITE.BIN, SYS.DSACOMF or 
SYS.DSACORE: 


the above parameters are the only ones applicable. 


When FILE = SITE.CATALOG, SITE.HELP or SITE.STARTUP: 
[ {IN_ACCRIGHT | INACCR}={0|1}] 


[ {RUN_ACCRIGHT | RUNACCR}={0|1}]; 


Parameters 

FILE names the file to be saved. This must be 
SYS.URCINIT, SITE.CATALOG, SITE.STARTUP, 
SITE.HELP, SYS.SITE.SL, SYS.SITE.BIN, 
SYS.DSACONF, or SYS.DSACORE. 

INVOL identifies the media name and devclass of the input 


volume containing: 


— SITE.CATALOG, when FILE = 
{SITE.CATALOG|SITE.STARTUP|SITE.HELP} 


— SYS.CATALOG, when FILE = 
{SYS.URCINIT|SYS.SITE.SL|SYS.SITE.BIN 
ISYS.DSACONF|SYS.DSACORE} 
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OUTVOL identifies the media name and devclass of the Set 
tape/cartridge volumes. 

Environment 

The running Set may be the P-Set, P2-Set, or R-Set. 


The tape/cartridge must have been prepared in advance, using the GCL procedure 
PREPARE TAPE or the VOLPREP utility. 


The user must be logged on under the SYSADMIN project, in order to be able to 
save the SITE.CATALOG. 


When the input SITE.CATALOG has its access rights validated: 


e The output SITE.CATALOG will also have its access rights validated. 


e Ifthe disk supporting the input SITE.CATALOG is not the running disk, the 
running disk's access rights are temporarily validated for the duration of the job's 
execution. 


The SITE.STARTUP and SITE.HELP input files must both be cataloged. 


Detailed purpose 


This function requests the SAVE_SITEFILES parameters, if these have not already 
been supplied with the command. 


The following files may be saved: 


SYS.URCINIT SITE.CATALOG 
SYS.SITE.BIN SITE.HELP 
SYS.SITE.SL SITE.STARTUP 
SYS.DSACONF SYS.DSACORE 
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The SAVE _SITEFILES function calls the JCL, as appropriate, for one of the 
following: 


IUF_CATSAVE, which uses the FILSAVE utility followed by the CREATE 
processor to save the SITE.CATALOG file. 


IUF_STPSAVE, which uses the LIBMAINT processor to move the 
SITE.STARTUP file. 


IUF_HELPSAVE, which uses the LIBMAINT processor to move the 
SITE.HELP file. 


IUF_URCSAVE, which uses the FILSAVE processor to save the 
SYS.URCINIT file. 


IUF_DSASAVE, which uses the LIBMAINT processor to move the 
SYS.DSACONF and SYS.DSACORE files. 


IUF_SITESAVE, which uses the LIBMAINT processor to move the 
SYS.SITE.SL and SYS.SITE.BIN files. 


EXAMPLES: 


G: SVSITE FILE=SITE.CATALOG INVOL=P2V9 :MS/FSA 
OUTVOL=SAV1V9 : CT; 


The SITE.CATALOG file is to be saved from the Set designated by 
"P2V9:MS/FSA"to the tape designated by "SAV1V9:CT". 


G: SVSITE FILE=SITE.STARTUP INVOL=P2V9 :MS/FSA 
OUTVOL=SAV1V9 :CT; 


The SITE.STARTUP file is to be saved from the Set designated by 
"P2V9:MS/FSA" to the tape designated by "SAV1V9:CT". 


G: SAVE_SITEFILES FILE=SYS.URCINIT INVOL=P2V9 :MS/FSA 
OUTVOL=SAV1V9 : CT; 


The SYS.URCINIT file is to be saved from the Set designated by "P2V9:MS/FSA" 
to the tape designated by "SAV1V9:CT". 


G: SVSITE FILE=SYS.DSACONF INVOL=P2V9 :MS/FSA 
OUTVOL=SAV1V9:CT; 


The SYS.DSACOMF file is to be saved from the Set designated by 
"P2V9:MS/FSA" to the tape designated by "SAV1V9:CT". 


Q 
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4.2.39 The UPDATE_GCOS Function 
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Purpose 


Updates the GCOS Domain of a P-Set, in RP- and PO configurations by applying a 
new Technical Status from a G-MEDIA. 

Also updates either the running Set or the non-running Set in a P2P configuration. 
If a P2P configuration is to be updated, it is assumed that the level of site patches is 
the same on both the P-Set and the P2-Set. 


For XTA system, starting from GCOS 7 TS 9920, the G-MEDIA can now be a CD- 
ROM. In this case, the content of this CD-ROM must be first transferred on a 
GCOS DISK using a script located on the CD-ROM, before using the 
UPDATE GCOS function.(see "Using CD-ROM on XTA Systems" below). 


Syntax 


{UPDATE_GCOS|UPDG} INVOL=media:devclass [OUTSET=set] ; 


Parameters 
INVOL identifies the media names and devclass of the 
volumes containing the Technical Status, which is 
recorded on a G-MEDIA. 
The syntax is: 
media-name] [/media-name2[/media-name3]]: 
<tape-dvce> 
or 
Gxxxx:MS (xxxx is the ts name , for example 9920) 
OUTSET identifies the Set to be updated. In a P2P 


configuration, this can be either the running Set or the 
non-running Set. The default value is the non-running 
Set. 


Using CD-ROM on XTA Systems 


For XTA Systems, if the G-MEDIA is a CD-ROM, its contents must be first 
transferred on a GCOS 7 Disk (in the file SYS.Gxxxx) by using a script located on 
the CD-ROM. 
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Please read the installation instructions located on the CD-ROM in the file 
ReadMe _Install_updg components.txt. 


Execute the following installation instructions, to transfer the contents of the 
G-MEDIA in the file SYS.Gxxxx: 


e Interop7 FTP servers must be started on Windows and GCOS 7 
e Launch a Windows “ Command Prompt ” session 
e Change your current directory for the CD-ROM directory 
e Issue the command: Install GCOS_TECHNICAL_ STATUS 
The following information are requested: 
- System Name: Windows name of the Diane System 


- Gcos Disk: Media name of a work disk for the SYS.Gxxxx file 
(media name without device type on which 700.000 
DBLKs free are necessary). The file SYS. Gxxxx will 
contain an image of the TECHNICAL STATUS. 


- Gcos user: Name of an user in project SYSADMIN, used to perform 
FTP transfer, from CD-ROM to GCOS 7 file 

- Password: GCOS 7 password of this user 

- FTP Port: FTP port number used to communicate with GCOS 7, 
usually 9037 


In case of first installation of a Technical Status located on a CD-ROM, GIUF tools 
have to be updated, in order to support installation using the SYS.Gxxxx file. You 
have to launch a JCL with command: EJ BFGIUF_MS LIB=SYS.HSLLIB. 


The file SYS.Gxxxx, containing an image of the GCOS 7 Technical Status, is used 
as input data, by the function UPDATE GCOS. In this case INVOL must be given 
in the form: Gxxxx:MS 


Because the file SYS.Gxxxx is catalogued in the SYS.CATALOG of the running 
GCOS 7 System, the functions UPDATE GCOS must be performed from this 
current running Set. 


The file SYS.Gxxxx is deleted at the end of the UPDATE GCOS function, so to 
execute again this function, it is necessary to transfer again the G-MEDIA content's 
in the SYS.Gxxxx file using the Install GCOS_TECHNICAL_ STATUS script. 


EXAMPLE: 


G: UPDG INVOL=G9920:MS; 
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Environment 
Both Sets must be of the same MI configuration, and mounted. The updated Set is: 


e The P-Set in RP- and PO configurations 
e the chosen Set (non-running or running) in a P2P configuration. 


If the updated Set has its access rights validated, in a P2P configuration, the 
running Set must also have its access rights validated. 


The UPDATE _GCOS function must be run after the DETECT_SITE function, and 
on the same running disk. 


This function must be submitted under the SYSADMIN project. 


Refer to the "Jmportant Note" in the paragraph GCOS 7 Updating Procedure in 
Chapter 7 "Updating Domains". 


Detailed purpose 


The UPDATE_GCOS parameters are requested, if these have not already been 
submitted with the command. 


A display is obtained of the: 


e Current GCOS 7 Technical Status of the updated Set. 
e The number of the Technical Status to be applied. 
e Technical Status of the Set that has not been updated. 


The JCL IUF_UPDG is called, and the LEVEL function is executed so that the two 
Sets are both brought to the latest Technical Status; this is done in an RP 
configuration from P-Set to R-Set. The following files are copied from the 
G-MEDIA onto the Set to be updated: 


e SYS.IUF 

e SYS.HSLLIB 

e SYS.HLMLIB 

e SYS.HCULIB 

e SYS.GPL.MACLIB 
e SYS.HBINLIB 

e SYS.C.INCLUDE 
e SYS.HELP 

e SYS.SYSTEM 
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12s IMPORTANT: 


If the user has placed any private subfiles in these libraries, they will be lost 
during the updating process. 


The SITE patches are extracted from the running Set, and reapplied in the new 
SYS.SYSTEM file as well as in the new SYS.HLMLIB library after the update. 


If the DETECT_SITE function has previously been run, the new patches that are 
the equivalent of the old site patches will be applied in the new SYS.SYSTEM file 
as well as in the new SYS.HLMLIB library after the update. 


After execution of the UPDATE GCOS function, the members COMAP and 
COMNAP located in the SYS.IUF library contain, respectively, the list of the site 
patches re-applied and the list of those that are not re-applied. These members are 
printed in the output report. 


The MIs are validated in the new SYS.SYSTEM file, from: 


e The non-updated SYS.SYSTEM file in RP and P2P configurations 


e Main Memory, in PO configurations. 


NOTE: 
In the case of the first update with GCOS 7-V9 or GCOS 7-V10, you must 
execute VALIDP with K-media supplied. 


The CONFIG job is executed, using the latest user COMFILE (containing the 
user's explicit CONFIG commands) saved to the LAST_CONFIG_INPUT member 
in the SYS.IUF library. 


An execution summary lists all the modules delivered, as well as all the reference 
and interim corrections (as appropriate) applied during the current 
UPDATE_GCOS execution. 


Set Evolution in a P2P configuration 


The P-Set alternates with the P2-Set as the running Set. The UPDATE_GCOS 
function is performed on the non-running Set just before it becomes the running 
Set. This allows the new Technical Status to be tried out on the running Set: 


e While conserving the non-running Set in non-updated form for backup purposes 
in the event of unforeseen problems with the new Technical Status. 


e So that the new Technical Status may be thoroughly tried out in production 
before performing the LEVEL function to copy it to the non-running Set. 
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P2-to-P 
LEVEL UPDATE_GCOS <— GIUF functions 
ts1 ts2 i <— P-Set TS 
—Y nl P-Set 
Yo P2-Set 
tsO ts1 ts2 ts3 <— P2-Set TS 
LEVEL UPDATE_GCOS LEVEL <— GIUF functions 
P-to-P2 P-to-P2 


— Production System Set. 
—— Backup System Set. 


Figure 4-1. Set Evolution in a P2P configuration 
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Set Evolution in an RP configuration 


The P-Set is always the running Set; the R-Set is always the backup Set. The 


UPDATE_GCOS function is always performed on the running Set. This allows the 


new Technical Status to be tried out: 


e While conserving the R-Set in non-updated form for backup purposes in the 
event of unforeseen problems with the new Technical Status. 


e So that the new Technical Status may be thoroughly tried out in production 
before performing the LEVEL function to copy it to the R-Set. 


UPDATE_GCOS UPDATE_GCOS + GIUF functions 
i ts2 ts3 + P-Set TS 
P-Set 
R-Set 
ts1 
ts2 ts3 <+ R-Set TS 
LEVEL LEVEL + GIUF functi 
arr Pto-R GIUF functions 


— Production System Set. 
— Backup System Set. 
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Figure 4-2. Set Evolution in an RP configuration 


EXAMPLE: 


G: UPDG INVOL=G99201/G699202:CT; 


The GCOS Domain of the P-Set, in RP- and PO configurations (or the non-running 


Set, in a P2P configuration), is to be updated with a Technical Status from the 
G-MEDIAs with the identifiers G99201:CT and G99202:CT. 


Q 
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Purpose 


This function is used to modify the MI configuration in the P-Set, P2-Set, or R-Set, 
as appropriate to the site, for instance, after a technical model upgrade. 
UPDATE MI functions cannot be used to validate MIs at installation time. 


Syntax 


{UPDATE_MI|UPMI} UPD_SET={P|P2|R} KEY_FILE=file78; 


Parameters 

UPD_SET identifies the Set in which the MI configuration is to 
be modified. 

KEY FILE describes, in GCL format, the file containing the key 
necessary for modification of the user's MI 
configuration. 

Environment 


The running Set may be the P-Set, P2-Set, or R-Set. 


If the output Set is already, or is to become, the running Set, an ISL RESTORE 
session must be run. 


When execution is completed, a warning message is displayed on the console and 
written in the JOR: 


* AN ISL RESTORE SESSION IS NECESSARY ON THE OUTPUT SET 
* IF THIS SET IS ALREADY OR IS TO BECOME THE RUNNING SET. 


EXAMPLES: 


G: UPDATE_MI UPD_SET=R KEY_FILE=MIKEY:MIKEY:CTSMFT; 


The key to be used is located in the file MIKEY on multifile-tape media MIKEY. 


G: UPMI UPD_SET=P2 KEY _FILE=SYS.IUF..MIKEY; 


The key to be used is in the subfile MIKEY located in the SYS.IUF file on the 
running Set. 


Q 
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The VALIDP Function 


Purpose 


This function performs GCOS 7 MI validation on the P-Set. 


Syntax 


{VALIDP|VALP} KEY={YES|NO}; 


When KEY=YES: 
{KEY_FILE|KEYF}=file78; 


When KEY=NO: 


{OLDVOL | OLDV}=media:devclass; 


Parameters 


KEY Must be defined as YES when the GCOS 7-V9 or 
GCOS 7-V10 Release as appropriate is installed for 
the first time on the system from a Key-file provided 
by the your Bull CSE. (This is the installation 
procedure for a 'new user'.) There is no default value 
for this parameter which must be stated explicitly. 


If NO, a previous GCOS 7-V9 or GCOS 7-V10 
Release as appropriate is already available on the 
system, and no Key-file is provided. (This is the 
installation procedure for an ‘update user'.) 


NOTE: This key cannot be entered directly via the 
console. 


When KEY = YES: 


KEY FILE defines the file description of the key used to validate 
the MI configuration. 
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When KEY = NO: 


OLDVOL identifies the media name and devclass of the old 
GCOS 7-V9 or GCOS 7-V 10 disk as appropriate 
containing the SYS.CATALOG. 


Environment 
The running Set may be the P-Set, a P2-Set, or an R-Set. 


If the output P-Set is already, or is to become, the running Set, an ISL RESTORE 
session must be run. 


Detailed purpose 


The job requests the VALIDP parameters, if these have not been submitted with the 
command. 


The JCL IUF_VALMI is called, to perform the following operations: 


e Read and decode the key, or get the MI configuration from the old 
SYS.SYSTEM file, depending on the KEY parameter. 


When KEY = YES: 


e Display the MIs to be validated. 
e Request agreement on the displayed MI list. 


e Validate the MI's concerned, and create the MICONF code in the SYS.SYSTEM 
file of the P-Set. 


When KEY = NO: 


e Retrieve the MI configuration from the old SYS.SYSTEM file, and validate it on 
the SYS.SYSTEM file of the P-Set. 


The following IUF_CONFSET member parameter is updated in the SYS.IUF 
library of the validated Set: 


e REFDISK = NO 
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The following members of the SYS.IUF library: 


IUF_SYSOPT2 (for GCOS 7-V9) 
IUF_SYSOPT2_XTA (for GCOS 7-V10) 
IUF PRIVATE MI 


are input data files used by the H_SYSOPT load module. 


IUF_SYSOPT2 or IUF_SYSOPT2_XTA as appropriate to the GCOS 7 Release 
contains standard MI data. The IUF_PRIVATE_ MI reference member may be 
replaced, at the request of your Bull CSE, by a new JUF_PRIVATE_ MI member 
containing MI data specific to the site, and missing from the current 
IUF_SYSOPT2 or IUF_SYSOPT2_XTA member. 


At each update of the GCOS Domain, an empty IUF_PRIVATE_ MI reference 
member replaces the current one, because the old site-specific MI data becomes 
standard MI data, that is normally contained in an updated IUF_SYSOPT2 or 
IUF_SYSOPT2_XTA member. If this is not the case, a new IUF_PRIVATE MI 
site-specific member must be delivered by your Bull CSE. 


When execution is completed, a warning message is displayed on the console and 
written in the JOR: 


* AN ISL RESTORE SESSION IS NECESSARY ON THE OUTPUT SET 
* IF THIS SET IS ALREADY OR IS TO BECOME THE RUNNING SET. 


EXAMPLES: 


G: VALP KEY=YES KEY _FILE=MIKEY :MIKEY:CTSMFT; 


GCOS 7 MI validation is performed on a P-Set. The key to be used is contained in 
the file MIKEY on the multifile tape MIKEY. 


G: VALP KEY=NO OLDVOL=PSETV9 :MS/FSA; 


GCOS 7 MI validation is performed on a P-Set. The MI configuration to be used is 
retrieved from the SYS.SYSTEM file cataloged in the SYS.CATALOG file, which 
is situated on the disk PSETV9. 


Q 


NOTE: 
The K-MEDIA is defined as: 


MD=MIKEY DVC=dvc EFN=MIKEY 
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4.2.42 The VALIDP2 Function 


Purpose 


This function performs GCOS 7 MI validation on the P2-Set. 


Syntax 


{VALIDP|VALP} KEY={YES|NO}; 


When KEY=YES: 


{KEY_FILE|KEYF}=file78; 


When KEY=NO: 


{OLDVOL | OLDV}=media:devclass; 


Parameters 


KEY Must be defined as YES when the GCOS 7-V9 or 
GCOS 7-V10 Release as appropriate is installed for 
the first time on the system from a 
Key-file provided by your Bull CSE. (This is the 
installation procedure for a ‘new user'.) There is no 
default value for this parameter which must be stated 
explicitly. 


If NO, a previous GCOS 7-V9 or GCOS 7-V10 
Release as appropriate is already available on the 
system, and no Key-file is provided. (This is the 
installation procedure for an ‘update user'.) 


NOTE: This key cannot be entered directly via the 
console. 


When KEY=YES: 


KEY FILE defines the file description of the key used to validate 
the MI configuration. 
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When KEY = NO: 


OLDVOL identifies the media name and devclass of the old 
GCOS 7-V9 or GCOS 7-V10 disk as appropriate 
containing the SYS.CATALOG. 


Environment 
The running Set may be the P-Set, a P2-Set, or an R-Set. 


If the output P2-Set is already, or is to become, the running Set, an ISL RESTORE 
session must be run. 


Detailed purpose 


The job requests the VALIDP parameters, if these have not been submitted with the 
command. 


The JCL IUF_VALMI is called, to perform the following operations: 


e Read and decode the key, or get the MI configuration from the old 
SYS.SYSTEM file, depending on the KEY parameter. 


When KEY = YES: 


e Display the MIs to be validated. 
e Request agreement on the displayed MI list. 


e Validate the MI's concerned, and create the MICONF code in the SYS.SYSTEM 
file of the P2-Set. 


When KEY = NO: 


e Retrieve the MI configuration from the old SYS.SYSTEM file, and validate it on 
the SYS.SYSTEM file of the P2-Set. 


The following IUF_CONFSET member parameter is updated in the SYS.IUF 
library of the validated Set: 


e REFDISK = NO 
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The following members of the SYS.IUF library: 


IUF_SYSOPT2 (for GCOS 7-V9) 
IUF_SYSOPT2_XTA (for GCOS 7-V10) 
IUF PRIVATE MI 


are input data files used by the H_SYSOPT load module. 


IUF_SYSOPT2 or IUF_SYSOPT2_XTA as appropriate to the GCOS 7 Release 
contains standard MI data. The IUF_PRIVATE_ MI reference member may be 
replaced, at the request of your Bull CSE, by a new JUF_PRIVATE_ MI member 
containing MI data specific to the site, and missing from the current 
IUF_SYSOPT2 or IUF_SYSOPT2_XTA member. 


At each update of the GCOS Domain, an empty IUF_PRIVATE_MI reference 
member replaces the current one, because the old site-specific MI data becomes 
standard MI data, that is normally contained in an updated IUF_SYSOPT2 or 
IUF_SYSOPT2_XTA member. If this is not the case, anew IUF_PRIVATE MI 
site-specific member must be delivered by your Bull CSE. 


When execution is completed, a warning message is displayed on the console and 
written in the JOR: 


* AN ISL RESTORE SESSION IS NECESSARY ON THE OUTPUT SET 
* IF THIS SET IS ALREADY OR IS TO BECOME THE RUNNING SET. 


EXAMPLES: 


G: VALP2 KEY=YES KEY _FILE=MIKEY:MIKEY:CTSMFT; 


GCOS 7 MI validation is performed on a Slave P-Set. The key to be used is 
contained in the file MIKEY on the multifile tape MIKEY. 


G: VALP2 KEY=NO OLDVOL=PSETV9 :MS/FSA; 


GCOS 7 MI validation is performed on a P-Set. The MI configuration to be used is 
retrieved from the SYS.SYSTEM file cataloged in the SYS.CATALOG file, which 
is situated on the disk PSETV9. 


Q 


NOTE: 
The K-MEDIA is defined as: 


MD=MIKEY DVC=dvc EFN=MIKEY 
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4.2.43 
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The VALIDR Function 


Purpose 


This function performs GCOS 7 MI validation on the R-Set. 


Syntax 


{VALIDR|VALR} KEY={YES|NO}; 


When KEY = YES: 


{KEY_FILE|KEYF}=file78 


When KEY = NO: 


{OLDVOL | OLDV}=media:devclass 


Parameters 


KEY Must be defined as YES if the GCOS 7-V9 or GCOS 
7-V10 Release as appropriate is being installed for the 
first time on the system, from a Key-file provided by 
your Bull CSE. (This is the installation procedure for 
a'new user’.) There is no default value for this 
parameter which must be stated explicitly. 


If NO, a previous GCOS 7-V9 or GCOS 7-V10 
Release as appropiate is already available on the 
system, and no Key-file is provided. (This is the 
installation procedure for an ‘update user'.) 


NOTE: This key cannot be entered directly via the 
console. 


When KEY = YES: 


KEY FILE defines the file description of the key used to validate 
the MI configuration. 
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When KEY = NO: 


OLDVOL identifies the media name and devclass of the old 
system disk containing the SYS.CATALOG file. 


Environment 
The running Set must be the R-Set. 


This function is not allowed in PO configurations. 


Detailed purpose 


The job requests the VALIDR parameters, if these have not been submitted with 
the command. 


The JCL IUF_VALMI is called, to perform the following operations: 


e Read and decode the key, or get the MI configuration from the old 
SYS.SYSTEM file, depending on the KEY parameter. 


When KEY=YES: 


e Display the MIs to be validated. 
e Request agreement on the displayed MI list. 


e Validate the MI's concerned, and create the MICONF code in the SYS.SYSTEM 
file. 


When KEY = NO: 


e Retrieve the MI configuration from the old SYS.SYSTEM file, and validate it on 
the running SYS.SYSTEM. 


The following [UF CONFSET member parameters are updated in the SYS.IUF 
library: 

e CONF =RP 

e REFDISK = NO 

The following members of the SYS.IUF library: 


IUF_SYSOPT2 (for GCOS 7-V9) 
IUF_SYSOPT2_XTA (for GCOS 7-V10) 
IUF PRIVATE MI 


are input data files used by the H_SYSOPT load module. 
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IUF_SYSOPT2 or IUF_SYSOPT2_XTA as appropriate to the GCOS 7 Release 
contains standard MI data. The IUF_PRIVATE_ MI reference member may be 
replaced, at the request of your Bull CSE, by a new JUF_PRIVATE_MI member 
containing MI data specific to the site, and missing from the current 
IUF_SYSOPT2 or IUF_SYSOPT2_XTA member. 


At each update of the GCOS Domain, an empty IUF_PRIVATE_ MI reference 
member replaces the current one, because the old site-specific MI data becomes 
standard MI data, that is normally contained in an updated IUF_SYSOPT2 or 
IUF_SYSOPT2_XTA member. If this is not the case, a new IUF_PRIVATE_ MI 
site-specific member must be delivered by your Technical Support. 


When execution is completed, a warning message is displayed on the console and 
written in the JOR: 


* AN ISL RESTORE SESSION IS NECESSARY ON THE OUTPUT SET 
* IF THIS SET IS ALREADY OR IS TO BECOME THE RUNNING SET. 


EXAMPLES: 


G: VALR KEY=YES KEY _FILE=MIKEY :MIKEY:CTSMFT; 


GCOS 7 MI validation is performed on the R-Set and the file containing the key to 
be used is called MIKEY and located on the multi-file tape MIKEY. 


G: VALR KEY=NO OLDVOL=PSETV9 :MS/FSA; 


GCOS 7 MI validation is performed on the R-Set. The MI configuration to be used 
is retrieved from the disk indicated in the SYS.SYSTEM file cataloged in the 
SYS.CATALOG file, which is situated on the disk PSETV9. 


Q 
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4.3 IUF Jobs 


4.3.1 The INSTAL_ALL Job 
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Purpose 


Allocates empty GCOS 7 files and restores loaded system files (belonging to the 
five file Domains) from the G-MEDIA, DOMAINS-MEDIA and FW-MEDIA to a 
work disk which will become the P-Set or the R-Set. 


The G-MEDIA, DOMAINS-MEDIA and FW-MEDIA may be either tapes or 
cartridges. 


This job creates either a P-Set or an R-Set, as appropriate. However, it is mainly 
used to create a P-Set when installing a new GCOS 7 Release. 


Syntax 


EJ INFILE=INSTAL_ALL:G-MEDIA-md:<tape-dvc>$MFT; 


Environment 
The INSTAL_ALL job is executed under the User and Project SYSADMIN. 


A complete VOLPREP in FBO format is necessary for a work disk that has been 
previously used as a system disk. 


One, two or three disks are required, according to the capacity of the used disks 
and the memory size specified at the installation of the Set. 
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Detailed purpose 


This JCL job is loaded from the INSTAL_ALL file, which is stored on the first 
G-MEDIA. 


INSTAL_ALL performs the following: 
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It requests, by means of SWI 


— The device classes of G-MEDIA, DOMAINS-MEDIA, FW-MEDIA 

— The type of Set to be built (P or R) 

— The type of DSA product to be installed (DNS and/or CNS and/or FCP7) 

— The media, device-class and memory requirements of the future P-Set or 
R-Set. 

— The memory size of the system 


It clears the future P-Set or R-Set 
It installs GCOS 7 files by 


— allocating empty GCOS 7 files. (Their size depends on the memory space 
reserved when SET=P) 
restoring loaded GCOS 7 files from the G-MEDIA 


It installs OLTD, DSA and GSF Domain files from the DOMAINS-MEDIA 
It installs FW Domain files from the FW-MEDIA 


It loads the IUF_CONFSET member from the IUF_CONFSETREF member, 
which is stored in the SYS.IUF library. At the same time, the PSETMD, 
PSETDVC, (or RSETMD, RSETDVC), CONF and DSA parameters are 
updated. 


It executes the CONFIG job which updates the System Device Tables in the 
SYS.SYSTEM file on the newly created system volume. 


47 A2 23US 


Installation and Updating Facility 


4.3.2 The INSTAL_GCOS Job 
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Purpose 


Allocates empty GCOS 7 files, and restores loaded GCOS 7 files from the 
G-MEDIA to a work disk which will become the R-Set. The G-MEDIA may 
consist of either tapes or cartridges. 


This job is used to create an R-Set when installing a new GCOS 7 Release. It is 
provided as a backup solution. When this solution is adopted, the other Domains 
are delivered by your Local Distribution Center on separate DOMAINS MEDIA 
(i.e. one media per Domain, as for previous GCOS 7 Releases). 


Syntax 


EJ INFILE=INSTAL_GCOS:G-MEDIA-md:<tape-dvc>$MFT; 


Environment 


A complete VOLPREP necessary for a work disk that has previously been used as a 
system disk. 


The INSTAL_GCOS job is executed under the User and Project SYSADMIN. 


Detailed purpose 


This job consists of JCL loaded from the file INSTAL GCOS, stored on the first 
G-MEDIA. The INSTAL_GCOS file is loaded at G-MEDIA creation time from 
the IUF INSTAL _ GCOS JCL member. 


The job runs the INSTAL GCOS job which: 


e Requests, by SWI, the MEDIA and DEVCLASS of the future R-Set disk, as well 
as the input DEVCLASS of the G-MEDIA. 


e Clears the future R-Set without track formatting. 


e Allocates empty GCOS 7 files, with an organization of SEQ or NONE as 
appropriate, on the future R-Set disk. 


e Restores other GCOS 7 files from the G-MEDIA, to the future R-Set disk, with 
the options OUTALC and CATNOW. 


e Loads the IUF_CONFSET subfile from the [UF_CONFSETREF subfile in the 
SYS.IUF file, with updating of the RSETMD and RSETDVC parameters. 


e Updates the R-Set SITE.CATALOG accordingly. 
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The INSTAL_PSET Job 


Purpose 


Allocates empty GCOS 7 files and restores loaded system files (belonging to the 
five file Domains) from the SET-MEDIA to a work disk which will become the 
P-Set. 

The SET-MEDIA may be either tapes or cartridges. 

This job is used to create a P-Set disk when installing a new GCOS 7 Release. 


Syntax 


EJ INFILE=INSTAL_PSET: SET-MEDIA-md:<tape-dvc>$MFT; 


Environment 
The INSTAL _PSET job is executed under the User and Project SYSADMIN. 


A complete VOLPREP is necessary for a work disk that has been previously used 
as a system disk. 


One or two disks are required, according to the capacity of the used disks and the 
memory size specified at the installation of the Set. 


Detailed purpose 


This JCL job is loaded from the INSTAL_PSET file, which is stored on the first 
SET-MEDIA (FSN=2). 

INSTAL _PSET is created by the SAVE_SET job from the IUF_INSTAL_PSET 
JCL member. 


INSTAL _PSET performs the following: 


e It requests, by means of SWI, the media, device-class and memory requirements 
of the future P-Set. 
e It clears the future P-Set. 


e It allocates empty GCOS 7 files on the future P-Set. (Their size depends on the 
memory size.) 


e It restores other GCOS 7, OLTD, DSA, GSF and FW files from the 
SET-MEDIA to the future P-Set, with the option OUTALC and CATNOW. 


It loads the IUF_CONFSET member from the IUF_CONFSETREF member, 
which is stored in the SYS.IUF library. At the same time, the PSETMD, 
PSETDVC, CONF and DSA parameters are updated. 
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4.3.4 The INSTAL_RSET Job 
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Purpose 


Allocates empty GCOS 7 files, and restores loaded system files (belonging to the 
five file Domains) from the SET-MEDIA to a work disk which will become the 
R-Set disk. The SET-MEDIA may be either tapes or cartridges. 


This job is used mainly to create the Slave R-Sets (Refer to the chapter Multi- 
System Installation and Updating). It may also be used to rebuild an R-Disk 
(should the existing R-Disk be destroyed) preceded by the SAVE_SET function (to 
make a save from the P-Set). 


Syntax 


EJ INFILE=INSTAL_RSET: SET-MEDIA-md:<tape-dvc>$MFT; 


Environment 


A complete VOLPREP is necessary for a work disk that has previously been used 
as a system disk. 


The INSTAL _RSET job is executed under the User and Project SYSADMIN. 


Detailed purpose 


This job consists of a JCL loaded from the file INSTAL RSET, stored on the first 
SET-MEDIA. INSTAL_RSET is created by the SAVE_SET job from the 
IUF_INSTAL_RSET JCL member. 


Runs the INSTAL_RSET job, which: 


e Requests, with the command SWI, the MEDIA and DEVCLASS of the future 
slave R-Set, as well as the Release relevant to the running disk. 


e Clears the future slave R-Set without track formatting. 
e Allocates empty GCOS 7 files, on the future slave R-Set system disk. 


e Restores other GCOS 7, FW, OLTD, GSF and DSA files from the SET-MEDIA, 
to the future slave R-Set, with the options OUTALC and CATNOW. 


e Loads the IUF_CONFSET member from the IUF_CONFSETREF member in 
the SYS.IUF library, with updating of the RSETMD, RSETDVC and DSA 
parameters. 
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5. CONFIG (Configuration) 


5.1 Introduction 


This chapter describes the configuration of GCOS 7 systems. 


The GCOS 7 software is supplied on a volume to be configured by the user for his 
site. CONFIG adapts the delivered software volume to the specific environment of 
the user's applications, and is carried out at his site. Figure 5-1 shows an overview 
of the CONFIG utility. 
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supplied 
SRST SYS.SYSTEM software 
System Resource | volume 
CONFIG and Status Table Resi or 
Statements SYSGEN/SYSOPT 
CONFIG 
v 
Execution 
SYS.SYSTEM Report 
Source Library: Source Library: 
SYS.IUF SYS.HSLLIB 
Member: Member: 


LAST_CONFIG_INPUT LAST _CONFIG_ REPORT 


Figure 5-1. CONFIG Overview 


5.1.1 Input 


The principal input to CONFIG includes: 


e The SRST (System Resource and Status Table) from the system disk, defining 
the status of the various devices available. 


e The SYS.SYSTEM file, on the system disk, containing the operating system and 
the system device tables used at Initial System Load (ISL). 


e A (sequential) configuration statement file containing statements (summarized 
and described later in this chapter), which specify the characteristics of the 
configuration. 
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5.1.2 Output 
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The results produced by CONFIG include: 


An execution report of the configuration of the site, in terms of: 

— hardware device configuration 

— explicit configuration commands 

— memory parameters 

— scheduling parameters 

— configured job classes 

— effective configuration commands 

— successful completion message, if appropriate 

— unsuccessful completion message(s), if appropriate. 
This output is also written to the SYS.HSLLIB library; for this reason, when 
running CONFIG you must have WRITE access to SYS.HSLLIB. 

An updated system volume. 


The commands used for the CONFIG run are recorded in the SYS.IUF library, 
so when running CONFIG you must also have WRITE access to SYS.IUF. 


NOTE: 


If CONFIG is run several times on the same system disk, the changes specified 
by the configuration statements are made only with respect to the original 
volume as delivered. Thus a second run of CONFIG, with one specified change 
for example, will cancel all previous configuration changes to the system 
volume, only the one specified change being performed. This feature provides a 
constant reference point, the status of the original volume. 
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5.2 System Device Tables 


GCOS 7 needs device tables (called System Device Tables), in order to access the 
hardware available at the site. Initial System Load (ISL) and CONFIG build and 
update the system device tables stored in the SYS.SYSTEM file on the delivered 
system volume. These tables initially describe a standard hardware configuration 
that is then adapted by CONFIG to meet the individual requirements of the site. 


CONFIG and ISL 


Configuration statements define the specific software requirements of the site. 
When CONFIG has updated the system volume, start the newly configured system 
using the following ISL options: 


1. RESTORE 
Restores the backing store from the configured master system volume. 
2. RESTART 


If the restore option is not issued, the backing store remains unchanged and the 
system status, after ISL, is the same as that of the original, plus any updating due to 
the RESTART option. 


If a correct RESTART option is not issued, the following message is displayed at 
the operator's console: 


CONFIG NEEDS RESTORE + RESTART CLEAN 


Followed by: IL01 OPTION? 


Normally, an incident such as a system crash (or the job being stopped by the 
operator) during a CONFIG run does not affect the system volume. However, a 
CONFIG abort during the switch from "Old" to "New" state of the system volume 
may leave the SYS.SYSTEM file in an "undefined" state. If CONFIG is run again, 
the file will reach its correct state; but, if there is no re-run and an ISL RESTORE 
option exists, the operator will receive the message: 


"CONFIGURATION PARAMETERS LOST DO YOU WANT TO RESTORE ?" 


If the reply is NO, RESTORE is not carried out; if the reply is YES, a special 
restore returns the backing store to its originally defined state. Run CONFIG again 
to configure the system device tables. 


5-4 47 A2 23US 


CONFIG (Configuration) 


5.3 Execution Procedure 


5.3.1 Basic Procedure 
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Format 
S: IV CONFIG; 


If there are no configuration statements, CONFIG acts on the resident system 
volume. Note that the 1V INVOKE) is equivalent to the EJ CONFIG operator 
command. 


NOTE: 
In an RP or P2P configuration, or with multi-system disks, after any 
reconfiguration evolution (FIRMGEN or BLOAD) is followed by a CONFIG 
on the running system disk, the first initialization of a non-running system disk 
must be performed with an INIT (never with a RELOAD). 
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5.3.2 Advanced Procedure 


CONFIG may be invoked as follows: 
The GCL request: 


S: EJ MYCONFIG; 


is submitted, to enter the job MYCONFIG which has been stored using the 
following JCL format: 


IV CONFIG VALUES= 

( [MEDIA=media, DEVCLASS=devclass] [, DUMP= {NO | DATA} 
[, COM_EFN={ DUMMY |com_efn} [ ,COM_ASP={ NIL |com_asp}]]] 
[, USER_CAT={ SITE.CATALOG |catalog-name}] ) 


Parameters 


MEDIA names the media containing the SYS.CATALOG to 
which the SYS.SYSTEM file to be configured is 
attached. 


DEVCLASS names the device-class for the media containing the 
SYS.CATALOG to which the SYS.SYSTEM file to be 
configured is attached. This parameter is mandatory if 
MEDIA is specified. If MEDIA and DEVCLASS are 
omitted, the SYS.SYSTEM attached to the resident 
SYS.CATALOG is configured. 


DUMP specifies the action to be taken in the event of a 
CONFIG abort, as follows: 


NO defines that no dump is to be performed. 
DATA requests a dump of the CONFIG job. 


COM_EFN names the file containing the configuration statements. 
The default value is DUMMY. 


COM_ASP specified with COM_EFN, assigns parameters for the 
file containing the configuration statements. The 
default value is NIL. 


USER_CAT names the catalog to which the file containing the 
CONFIG statements is attached; by default, this is 
SITE.CATALOG. 
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EXAMPLE: 


S: EJ MYCONFIG; 


which runs the standard job stored under the name MYCONFIG, containing the 
following: 


SJOB MYCONFIG USER=OPERATOR; 


IV CONFIG VALUES= 
(DUMP=DATA, COM_EFN=DISK-FILE, 
COM_ASP='DVC=device, MD=media, SHARE=DIR, MB=IN_CONFIG') ; 


ENDJOB ; 


NOTES: 


1. Inan RP or P2P configuration, or with multi-system disks, after any 
reconfiguration evolution (FIRMGEN or BLOAD) is followed by a 
CONFIG on the running system disk, the first initialization of a 
non-running system disk must be performed with an INIT (never with a 
RELOAD). 


2. The parameters DVC, MD, and SHARE present in the argument of 
COM_ASP in the example above are used only when <DISK-FILE> is 
uncataloged. 


GCOS 7 System Installation Configuration and Updating Guide 


5.4 


5.4.1 


Configuration Statements 


Syntax and Convention 


Configuration statement syntax is similar to that of JCL, except that: 


1. There is no continuation character. 


2. The end of record acts as a delimiter. 


All normal JCL syntax facilities remain: 


1. Free format. 


2. Keyword parameters may be supplied in any sequence. 


There may be any number of blanks before or after a separator. Thus, if a 
comma or semi-colon used as a separator is preceded by or followed by 
blanks, such blanks are ignored. 


4. Use of positional and/or keyword parameters. 


5. _Acomma separator is not mandatory between the arguments of a statement. 


6. Itis possible to insert comments in a set of configuration statements: 


{COMMENT |COMM|C} comment text; 


7. "$" signs may optionally prefix statement names. 


The same conventions, including notation variables, are used as in JCL description; 


1.€.: 


digitN 


alphaN 


identifierN 


indicates a decimal string of digits in the range 0 
through 9, of maximum length N. For example, for 
digit3: 


123 


indicates a string of alphabetic characters in the range 
A through Z, of maximum length N. For example, for 
alpha6: 


AZERTY 


indicates a string of length N containing alphanumeric 
characters (A through Z, 0 through 9), beginning with 
an alpha. For example, for identifier4: 


A38Z 
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CONFIG (Configuration) 


indicates any string of maximum length N characters, 
enclosed between single quotes. For example, for 
string 10: 


'AZERTY12+1' 


A single quote (') may be used in a protected string, 
by entering it twice (''). For example: 


PRLOG COMMAND='A AB''AB'' A' 


is interpreted as: A AB'AB' A 
because a double quote (' ') within a protected string 
represents ('). 


5.4.2 Summary of Configuration Statements 
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ACCOUNT 
ACTSIZE 


BJSIMU 


DEFORG 


DEVTRACE 
DJPCTL 


DUALSYS 


DUMPACT 


FILEOPT 


FILSHARE 


Accounting: specifies the accounting function. 


Accounting file size: specifies the size of the 
accounting file. 


BEFORE JOURNAL simultaneities: specifies the 
maximum number of jobs simultaneously able to use 
the Before Journal. 


Defines the default volume organization for sites that 
support both VBO and FBO volumes. 


Device for trace: specifies the trace default device. 


Distributed Job Processing Control: specifies the 
maximum number of transfer processors allowed at 
any one time. 


Dual systems: specifies the serial number of the 
second CPU in a pair of coupled systems (if 
applicable). 


DUMPACT utility: specifies the OCL statement to be 
executed automatically whenever an accounting file 
becomes full. 


Enables the activation of the site-specific file 
management system options. 


File sharing: specifies the maximum number of jobs 
that may share any single file. 
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GAC 


INPUTCTL 
JOBCLASS 


JBCLASS2 


JORSIZE 


JPPCDIM 


LSYS 


MAXCAT 


MAXDEF 


MAXFILE 


MAXIODEV 


MAXJOB 


MAXTAPE 


MAXTASK 
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General Access Control: specifies the GAC 
parameters. 


Specifies the input control options and parameters. 


Mono-letter Job Class: specifies the system default 
values for a mono-letter job class (A to Z). 


Double-letter Job Class: specifies the system default 
values for a double-letter job class (AA to ZZ). 

Up to 220 double-letter job classes may be specified in 
a single CONFIG session. 


Job Occurrence Report size: specifies a maximum 
limit of lines that may be printed for any single JOR. 


JPPC dimension. Determines which of the five 
variants of the system service job, JPPC, will allocate 
segments for TDS applications using XCP2 or IQS. 


Local system: specifies the local system's name, for 
use in a DSA network environment. 


Maximum number of catalogs: specifies the maximum 
number of catalogs that may be known in the system at 
any one time. 


Maximum number of DEFINEs: specifies the 
maximum number of DEFINEs that may be active in 
the system at any one time. 


Maximum number of files: specifies the maximum 
number of files that may be active at any one time. 


Maximum Input Output devices: specifies the 
maximum allowed number of I/O devices per station. 


Maximum number of jobs: specifies the maximum 
number of jobs that may be known to the system at any 
one time. 


Maximum number of tape cartridges: specifies the 
maximum number of tape cartridges that may be 
known to the system. 


Specifies the maximum number of tasks that are to be 
allowed to be executing simultaneously. 
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MULTLEV 


OWCLASS 


OWDEVICE 


OWDFLT 


PRLOG 


PRLOGC 


QUEUED 


SADMOPT 


SECOPT 
SITEOPT 
VCAMSCN 
VOLORG 


XAS 
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Multi-programming level: specifies the maximum 
number of jobs that may be "Started" (i.e., ina 
post-scheduling state) at one time. 


Output Writer class: specifies the PRIORITY and 
MEDIA system defaults applicable to the output writer 
devices connected to the system. 


Output Writer Device: specifies the system defaults to 
be applied for the CLASS parameter when used in 
SOW commands, for the output writer devices 
applicable. 


Output Writer default: specifies the system defaults for 
the CLASS, DEVCLASS, TAPE and Banner 
parameters in JCL/GCL statements. 


Print SYS.ERLOG file: specifies the threshold value at 
which printing of the SYS.ERLOG file is to be 
triggered. 


Print the SYS.LOGC file: specifies the threshold value 
at which printing of the SYS.LOGC file is to be 
triggered. 


Cache mechanism on directory and BAM (Block 
Allocation Map) blocks for queued files. 


System administrator options: selects options specific 
to the System Administrator. 


Security options: selects options specific to security. 
Site Options: activation of specific options on site. 
VCAM Session Connection 


Defines the authorized volume organization on sites 
that support both VBO and FBO volumes. 


Extended Address Space 
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5.4.3 
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The ACCOUNT Statement 


Purpose 


Specifies all or part of the accounting function. This parameter may be modified 
only by a subsequent run of CONFIG. 


Format 


ACCOUNT { ALL |NO|[, STEP] [, JOB][, END][, USER][, JOBOUT] 
[, JOBEX]|[, MPROC][, SVIOL][, FVIOL][, TDS] 
[, FILEUPD][, TW]} ; 


Parameters 


If specifying neither ALL nor NO, at least one of the other parameters should be 
used; otherwise the default of ACCOUNT ALL; will apply. If specifying more 
than one parameter, the use of commas as separators is required. 


ALL every type of accounting record is to appear in the 
accounting file together with any user-specified 
accounting records; ALL is the default value. 


NO no accounting is required. 
STEP step records are to be written to the accounting file. 
JOB job records are to be written to the accounting file. 


This parameter is retained for compatibility with 
earlier releases and is the equivalent of JOBOUT plus 
JOBEX. 


END a record is to be written to the accounting file at each 
shutdown (GCL command TSYS1) or RESTART. 


USER enables the user to write information to the accounting 
file. 

JOBOUT job output records are to be written to the accounting 
file. 

JOBEX job execution records are to be written to the 


accounting file. 


MPROC multi-process step records are to be written to the 
accounting file; this parameter may not be specified 
without STEP. 
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SVIOL system violation records are written to the accounting 
file. 

FVIOL file violation records are written to the accounting file. 

TDS TDS accounting records (TDS session and TDS user 
activity records) are to be written to the accounting 
file. 

FILEUPD file updating records are to be written to the 


accounting file. 


TW GTWriter accounting records are to be written to the 
accounting file. 


EXAMPLES: 

ACCOUNT ALL; 

This statement specifies that all records are applicable. 
ACCOUNT STEP, JOB, END, USER; 


This statement specifies that only the STEP, JOBOUT, JOBEX, END and USER 
records are applicable. 


ACCOUNT NO; 
This statement specifies that no accounting is required. 


Q 


Remarks: 


If ALL is specified, the Working Set cost of accounting at step level is 
approximately: 


e 5K at step termination 
e 5K at job termination. 


Likewise, events corresponding to other keywords each cost approximately the 
same amount of Working Set. 


Job management, the various job accounting facilities available are described 
together with the construction of the accounting file, in the System Administrator's 
Manual. 
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5.4.4 The ACTSIZE Statement 


Purpose 


Specifies the size of the virtual memory management (VMM) accounting file. 
Once set, this parameter may be modified only by re-running CONFIG. 


Format 


ACTSIZE { 200 |nnnn} 


Parameters 


The size specified by this statement is in units of backing store allocation, each of 
which is equal to 8K bytes. 


nnnn a decimal value of up to 4 digits, ranging from 1 
through 2000, to define the size of an accounting file 
in units of 8K. The default value is 200 units (1600K). 


EXAMPLE: 


ACTSIZE 100; 


This statement specifies that provision be made for 100 units (800K) for 
accounting information. 


Q 
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Remarks: 


The accounting mechanism is based on two accounting files working in flip-flop 
mode; thus, if a value n is used (ACTSIZE n;), the total cost is 2 x n units of 
backing store. 


When one accounting file is full, one of the messages: 


ACO1 GCOS: ACCOUNTING FULL. RUN DUMPACT 


ACO2 GCOS: ACCOUNTING FULL. DUMPACT COMMAND SUBMITTED 


is displayed at the main operator console, depending on the DUMPACT statement 
in CONFIG; accounting information is written to the second file. 


The size of the various accounting records is specified in the accounting 
documentation, for instance: 


JOBOUT is specified as 181 bytes 
JOBEX is specified as 115 bytes 
STEP is specified as up to 1383 bytes. 
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The BJSIMU Statement 


Purpose 


Specifies the maximum number of jobs which, at any given time, may use the 
Before Journal file. These jobs may be of any type (IOF, TDS, Batch). 


Format 
BJSIMU nnn ; 
Parameters 
nnn specifies a decimal value of up to 3 digits, ranging 
from | through 254, subject to the following 
conditions: 
— if the value is out of range, 8 is assumed. 
— if no value is given, then: 
if JMAX is greater than 8, the default value is 
(JMAX-4). 
if JMAX is less than or equal to 8, the default value 
is (IMAX-2). 
JMAX specifies the maximum number of jobs that 
may run concurrently, as specified in the MULTLEV 
statement. 
EXAMPLES: 
BUJSIMU 40; 


The specified value of 40 is used. 


BJSIMU; 


If the JMAX value in the MULTLEV statement is greater than 8, a default value of 
(JMAX 4) is used; otherwise, if JMAX is less than or equal to 8, a default of 
(JMAX - 2) is used. 


Q 


47 A2 23US 


47 A2 23US 


CONFIG (Configuration) 


Remarks: 
Use of this statement gives: 


e asaving of backing store space (of approximately 0.4K per job using the 
Journal), as compared with the default value. 


e apossible saving of memory space when the Before Journal is activated (of a 
maximum of approximately 1.5K). 


e asaving of | track per job using the Before Journal, in the SYS.JRNAL file. 


When a value of BJSIMU is specified through CONFIG, it must be consistent with 
the size given for the SYS.JRNAL file: 


n: value of BUJSIMU 
m: Size of SYS.JRNAL in blocks 
m=(n + 2) * 132 blocks of 512 bytes 
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5.4.6 The DEFORG Statement 


Purpose 


On a site that supports both VBO and FBO disks, DEFORG defines the default 
disk type used by the VOLPREP utility in the case of a volume preparation of a 
CKD disk (for data purposes only). 


Format 


DEFORG {VBO|FBO}; 


Parameters 

VBO The disk is prepared in VBO format. 
FBO The disk is prepared in FBO format. 
Remark: 


This option is taken into account only if the site supports a configuration of mixed 
disk types (and VOLORG default value is ALL). 
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5.4.7 The DEVTRACE Statement 
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Purpose 


Provides a trace of events occurring on any device, for display at the operator 
console. 


The type of event may be selected; for example, Abnormal, Attention, Warning, 
Alarm. If the specified type of event occurs on any device, it is reported by 
appropriate messages at the operator console. 


Format 


DEVTRACE [ABN] [ATN] [WARN] [ALARM] ; 


Parameters 


If there is no DEVTRACE statement, no device trace is provided at the operator 
console. If DEVTRACE is specified, at least one parameter must be defined. 


ABN specifies that every abnormal event (in the 
SYS.ERLOG sense) is to be displayed at the operator 
console. 


ATN specifies that every attention message (in the 
SYS.ERLOG sense) is to be displayed at the operator 
console. 


WARN specifies that every warning message ("normal" errors, 
in the SYS.ERLOG sense) is to be displayed at the 
operator console. 
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ALARM specifies that an alarm message be given at the 
operator console, at each nth occurrence of an 
abnormal event warning. The threshold value depends 
on device type. 


Device n 
URC 6) 
MTC 100 
MSC 10 


EXAMPLE: 


DEVTRACE WARN; 
Only warning messages are displayed at the operator console. 


Q 


5-20 47 A2 23US 


5.4.8 The DJPCTL Statement 


47 A2 23US 


Purpose 
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The Distributed Job Processing ConTroL command specifies the maximum number 
of transfer processors that may exist at any one time on the site. 


Format 


DJPCTL MAXTFS] 


Parameters 


MAXTFESIT 


MINEVERY 


[T={ 2 | nnn} MINEVERY={ 15 | mn }; 


introduces a decimal value of up to 3 digits, ranging 
from 0 to 255, to assign an upper boundary to the 
number of GTPs (Generalized Transfer Processors) 
that may be "started" (executing or idle) at any one 
time on the system being configured. These GTPs are 
used to transfer jobs, files or output files to other sites 
known to the system's network description. The 
default value is 2. 


introduces a decimal value of up to 2 digits, ranging 
from | to 15, to assign a minimum delay in minutes 
between two consecutive executions of a repeated 
EFTR/EJR request (parameter EVERY=). The default 
is 15 minutes. 
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Remarks: 


The MAXTFSIT parameter's effect may be overridden dynamically, using the GCL 
request MDDJP. 


This value also limits the number of Readers + "local" GTPs that may start. A 
"local GTP" is a GTP doing local file transfers; INFILE and OUTFILE are local 
files. 


If local file transfers are performed before job submission, GTPs are created which, 
when finished, do not disappear but become IDLE jobs, thus preventing potential 
Readers from starting. 


On the other hand, Readers may be made permanent (remain in EX state) using 
either the INPUTCTL statement of CONFIG or the GCL command "SIR PERM". 
In this case, if the number of Readers reaches the value of MAXTFSIT, no local 
GTP can start. 


Should such a situation arise, the operator should issue: 
MDDJP m SITE=local-site 


where m is greater than the value defined for MAXTFESIT. 
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The DUALSYS Statement 


Purpose 


For use with coupled systems, specifies the serial number of the second CPU 
concermed in order to allow the resolution of deadlocks over shared resources. 


Format 


DUALSYS cpu-sn [, MYSELF=cpu-sn] ; 


Parameters 


cpu-sn specifies an 8-digit hexadecimal value identifying the 
CPU serial number concerned, and conforming to the 
following conditions: 


e Used after DUALSYS to indicate the CPU serial number of the second CPU ina 
coupled system configuration. This parameter is mandatory whenever the 
system on which the CONFIG is being run ("system A") has been coupled with 
another system ("system B"), and its value must accurately reflect the real CPU 
number of "system B". 


e When introduced by the MYSELF keyword, is only required when both: 


— The "system B" is linked to yet another system ("system C"; i.e., other than 
"system A", on which the CONFIG is being run) also in a second coupled 
system configuration 


— The CPU serial number of "system A" is greater than that of "system B", and 
the CPU serial number of "system B" is greater than that of "system C" - a 
situation that would cause resource deadlocks. 


If the above 2 conditions are both satisfied, this MYSELF keyword must specify an 
arbitrary CPU number for "system A" which is less than the "real" CPU number 
specified for "system B" directly after DUALSYS. In this case, no resource 
deadlocks will be allowed to occur between any of the 3 systems concerned. 


With reference to the above "arbitrary" CPU number, check with your Bull 
representative that the CONFIG statement SITEOPT has not been set. If SITEOPT 
has been defined, verify that the bit, which triggers checking of the real CPU 
number, has not been set. 
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EXAMPLES: 


DUALSYS 87501234; 


The serial number of the second CPU in a coupled system configuration is 
specified as 87501234. 


DUALSYS 85401234, MYSELF=84101234; 
The serial number of the second CPU of a coupled system is specified as 
85401234, and the serial number of the first CPU is specified as 84101234. 


Q 


Remarks: 


The DUALSYS statement is applicable only when the Coupled System Support 
software product has been ordered and validated. 
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5.4.10 The DUMPACT Statement 


Purpose 


This command specifies the OCL statement to be executed automatically whenever 
an accounting file becomes full. It defines the OCL statement that will be used by 
the system when executing the DUMPACT utility. 


Format 


DUMPACT COMMAND={'ocl-request'| NO } ; 


Parameters 

ocl-request defines a string containing a maximum of 105 
characters, enclosed within single quotes. This must 
specify a valid operator command to be obeyed, as 
soon as either of the two-system accounting Virtual 
Memory files becomes full. 
NO is the default value. 

EXAMPLE: 


DUMPACT COMMAND='EJR DUMPJOB, , USER.JCLLIB' 


, 


where the JCL contents of the USER.JCLLIB library member DUMPJOB are: 


SJOB DUMPJOB USER=SYSADMIN PRTY=0; 

STEP H_DUMPACT SYS.HLMLIB OPTION='AP DB' XPRTY=1; 
ASSIGN USERACTF TESTFILE DVC=MS/FSA MD=FSD68; 
ENDSTEP ; 

JUMP CONTINUE; 

STEP H_DUMPACT SYS.HLMLIB OPTION='AP 1E' XPRTY=1; 
ASSIGN USERACTF ACCFILE DVC=MS/FSA MD=FSD68; 
ENDSTEP ; 

SENDJOB ; 


Q 
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Remarks: 


The system default option (when no DUMPACT statement is provided at CONFIG 
time) is to warn the operator with the repetitive message: 


*ACO1.GCOS: ACCOUNTING FULL.RUN DUMPACT 
whereupon the operator should start a DUMPACT utility job. 


If, on the other hand, a DUMPACT statement is provided with CONFIG, the 
system uses this statement and the following message is issued: 


*ACO2.GCOS: ACCOUNTING FULL.DUMPACT COMMAND SUBMITTED 


However, CONFIG does not test the validity of any operator command coded with 
the COMMAND keyword. In the event of an accounting file becoming full, 
coding the DUMPACT statement (particularly in the way shown in the example 
above) will avoid operator intervention, thus reducing delays to production 
programs. 
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Purpose 


CONFIG (Configuration) 


This command enables the activation of site-specific file management options. 


Format 


FILEOPT 


Parameters 


COMPTS 


[COMPTS= {PREVIOUS |CURRENT ] 
[MNIWORK={YES|NO} ] 
[CTFIRST={YES|NO} ] 
[LASTDATE={YES|NO} ] 
[USESITE={YES|NO} ] 
[CTUNLOAD={YES|NO} ] ; 


provides compatibility with the specified Technical 
Status. 


This parameter enables the system administrator to 
keep the file system susbstantially compatible with an 
earlier Technical Status and those that follow it. The 
earlier Technical Status is that used, for instance, on a 
backup system or the other system in a coupled system 
configuration. The argument of COMPTS defines the 
oldest Technical Status that can use the files or 
catalogs of the current system. GCOS 7 uses this 
value to decide whether new file system features 
controlled by COMPTS that are not backward 
compatible are to be used or not. The system 
administrator can subsequently update the value when 
the earlier Technical Status is finally abandoned. 


NOTE: Only Technical Statuses still supported and 
significant from a file system point of view may be 
specified. 


COMPTS can be set to PREVIOUS or CURRENT: 


PREVIOUS (the default value) specifies compatibility 
of the file system with the Technical Status 
immediately preceding the current one. Files can 
allocated no more than 16 extents, per volume. 
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MNTWORK 


CTFIRST 


LASTDATE 


USESITE 


CURRENT specifies compatibility of the file system 
with the current technical status only (no backward 
compatibility is required). Files can be allocated 
dynamically up to 255 extents per volume. 


If set to NO (the default value), when a cataloged file 
is assigned with an empty media list, an error occurs. 


If set to YES, when a a cataloged file is assigned with 
an empty media list: 


— if there is at least one tape unit on the site a request 
is issued for a work tape to be mounted, 


— if there are only cartridge units on the site or if 
device type CT is recorded in the cataloged file 
description, a request is issued for a cartridge to be 
mounted. 


The retrieval order for devices can be changed by the 
CTFIRST parameter (see below). 


If set to NO (the default value), the type of media is as 
described for the MNTWORK parameter above. 


If set to YES (allowed only if MNTWORK=YES), the 
order for device retrieval is changed to: 


CT/LIB, CT/M5/C, CT/MS5, MT, CT. 
The class retained is the first available on the site. 


If set to YES (the default value), the dates of last 
reference and last modification are updated when the 
file is closed even if there has been no I/O. 


If set to NO, the dates of last reference and last 
modification are updated when the file is closed only if 
there has been any I/O. 


If set to NO (the default value), the default volset for 
the project is used and the function aborts if there is 
insufficient space. 


If set to YES, the site volset is used for permanent file 
space if the default project volset is full. 
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CTUNLOAD For a cartridge library only. If YES, at the end of an 
IOF command, cartridges are automatically 
dismounted unless the LEAVE option was specified in 
this command or if the PASS option was specified in 
this or a previous command. 

If NO, at the end of an IOF command, cartridges 
remain premounted if the step does not contain, 
explicitly or implicitly, the UNLOAD option. Note, 
however, that cartridges are ALWAYS dismounted at 
the end of the job. 


EXAMPLE: 


FILEOPT COMPTS=PREVIOUS ; 
The file system must be kept compatible with the previous Technical Status. 


Q 
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5.4.12 The FILSHARE Statement 


Purpose 


Specifies the maximum number of jobs that may share ANY SINGLE FILE (such 
as a specific catalog, for instance) concurrently. This number may be modified 
only by a subsequent run of CONFIG. 


Format 


FILSHARE { Min (MULTLEV+1, 250) | nnn } ; 


Parameters 


nnn specifies a decimal value of up to 3 digits, ranging 
from 2 through 250, to define the maximum number of 
jobs that may ever share the same file concurrently. 
Each time the system assigns a file, this counts for one 
job. Note that, ifa file is assigned more than once in a 
step, this still counts for only one job. The default 
value is Min (MULTLEV+1,250). 


EXAMPLE: 


FILSHARE 100; 


No file may ever be shared by more than 100 jobs concurrently. 


Q 
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Remarks: 


FILSHARE is used together with MAXFILE, to determine parameters important to 
system performance such as: 


e the SYS.KNODET block size 
e the maximum number of subfiles assigned to a given file. 


The following formulas show the precise relationship: 


BKSIZE (sys.knodet_block-size) = the smallest factor of 512 
that is > 424 + (52 * fileshare) 


DEF_PER_BK (number-of-defines-in-a-sys.knodet-block) = integer_part (bksize/150) 
NDF (max. number of DEFINES) = MAXDEF (see MAXDEF statement) 


NBBK_DEF (number-of-blocks-used-to-contain-defines) is then computed using 
the ratio: 


ndf/def_per_bk 
KS (total-size-of-sys.knodet)=bksize * (maxfile + nbbk_def) 


Of course, this computation may sometimes result in a theoretical SYS. KNODET 
size greater than that actually built by TAILOR. Should this arise, the system will 
react in the following way: 


1. It computes the ratio: 
R=maxfile/maxdef 
2. Ifthe result R is in the range 1| through 4: 


MAXFILE and MAXDEF will both be reduced to a value compatible with the 
size of SYS.KNODET that is consistent with the ratio R. 


3. IfR is less than 1 or greater than 4: 


An adjustment will be made to set R to 1 (if less) or to 4 (if greater), with the 
same effect on MAXFILE and MAXDEF as in 2) above. 


Depending on the action actually taken, messages will be sent at GCOS 7 
initialization: 


DFO4 MAXIMUM NUMBER OF ASSIGNED FILES HAS BEEN REDUCED TO xxx 


DFO5 MAXIMUM NUMBER OF DEFINES HAS BEEN REDUCED TO xxx 


DFO5 MAXIMUM NUMBER OF DEFINES HAS BEEN INCREASED TO xxx 
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5.4.13 
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The GAC Statement 


Purpose 


Specifies GAC (i.e., General Access Control) parameters. 


Format 


GAC [LONGWAIT={ 60 |nnn}] [, LOCKSIZE={ 20 |nnn}] 
[, NBLOCKID={ 100 |nnnn}] ; 


Parameters 


LONGWAIT 


LOCKSIZE 


NBLOCKID 


supplies a decimal value of up to 3 digits, ranging from 
0 through 300, with a default of 60. 


If a tenant retains a resource beyond the maximum 
time specified in LONGWAIT, on initiation of a 
commitment unit, other requestors of that resource 
receive the LONGWAIT notification together with the 
identity of the current tenant. 


supplies a decimal value of up to 3 digits, ranging from 
5 through 320, to specify the maximum size of the 
"lock list" in K bytes, to be used by GAC for holding 
details of the CIs locked by users of the system. The 
default value is 20. 


supplies a decimal value of up to 4 digits, to specify 
the maximum number of LOCKIDs that may be active 
in GAC simultaneously. 


LOCKID is the "lock-owner-identifier" allocated: 
— at step initiation for batch processing 
— at transaction initiation for TDS. 


The H_DEFLOCK primitive returns this value in order 
to be able to identify requestors on LONGWAIT 
notifications. The default value is 100. 


The maximum possible value for NBLOCKID is 4095. 
The value of NBLOCKID should satisfy the condition: 


NBLOCKID * 20 < LOCKSIZE * 1024. 
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EXAMPLE: 


GAC LOCKSIZE=50, LONGWAIT=100, NBLOCKID=120; 


This means that TDS or IOF, as appropriate, will be notified if a waiting time 
greater than 100 seconds has occurred. 


Q 


Remarks: 


This GAC statement is applicable only when the GAC and/or TDS product has 
been ordered and validated; refer to the GAC-EXTENDED User's Guide. 
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5.4.14 The INPUTCTL Statement 


Purpose 


Specifies the input control options and parameters required for the system. 


Format 


INPUTCTL 


Parameters 


SJREADER 


JTRA 


HSLLIB 


HOABORT 
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SJREADER={TERM| NTIERM }] 
HSLLIB={ SYS.HSLLIB |xxx}] 
JTRA={TERM| NTERM }] 
HOABORT={YES|NO} ] ; 


specifies SIREADER service job behaviour, as 
follows: 


TERM: specifies that the service job is to terminate as 
soon as there are no further EJ requests pending. 


NTERM: after a COLD RESTART, when the first EJ 
request has been processed, the SJREADER service 
job is to remain in execution (EX) waiting for the next 
EJ request. This is the default value. 


specifies JTRA service job handling, as follows: 


TERM: JTRA is to go into the IDLE state, as soon as 
there are no more jobs to be translated. 


NTERM:JTRA is to wait for the next job to be 
translated (that is, remains in EX). This is the default 
value. 


a maximum of 44 characters, identifying the default 
system HSLLIB; the default value is SYS.HSLLIB. 


YES: all jobs, aborting at JCL translation time, will 
have their output (JOR) held automatically. This 
allows the output to be more easily scanned. 


NO: (default) job outputs are not held unless explicitly 
requested by the HOLDOUT parameter of EJR or 
$JOB. 
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EXAMPLE: 


INPUTCTL SJREADER=NTERM, JTRA=NTERM; 


The READER and JTRA service jobs are to wait if necessary for the next EJ 
request while remaining in EX state. 


Q 


Remarks: 


The NTERM option for the SSREADER service job, costs 4K of memory while 
waiting for EJ requests. However, EJ requests will be processed more quickly. 


The NTERM option, for the JTRA service job, costs 48K of memory while waiting 
for jobs to be translated. However, jobs will be translated as soon as they are 
introduced, regardless of the system load. 
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5.4.15 
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The JOBCLASS and JBCLASS2 Statements 


Purpose 


These statements specify the job management system default values for the 
applicable mono-letter (A to Z, JOBCLASS statement) or double-letter (AA to ZZ, 
JBCLASS2 statement) job classes. System default values include: 


e execution and scheduling priorities, and the limits of these priorities 

e the multiprogramming level 

e the state at system start-up 

e connection of a class to a job class group 

e default limits of steps for CPU times, elapsed times and SYSOUT number of 
lines. 


It is possible to override some default values attached to a job class by using: 


e the PRIORITY parameter in the JCL statement JOB, 


e the XPRTY,ELAPTIME, CPTIME or LINES parameters in the JCL statement 
STEP or in the GCL command EXEC_ PG. 


The default values attached to each JOBCLASS are usually changed using the 
MODIFY_LOAD (MDLD), TERMINATE LOAD (TLD) and START LOAD 
(SLD) main operator commands. However, the JOBCLASS and JBCLASS2 
configuration statements may be used to prevent a main operator from modifying 
the default values (parameters: NSC, NUXPRTY, NMPRIO and NMLOAD). 


The connection of a class to a job class group may be changed dynamically using 
the CONNECT LOAD (CNLD) and DISCONNECT LOAD (DISLD) main 
operator commands. 


Format 

JOBCLASS job-class [, XPRTY=n] [, XPRLIM={ 0 |n}] 
[, PRIORITY=n] [, PRLIM={ 0 |n}] 
[, MAXLOAD=nnn] [, { STARTED |NSTARTED}] 
[, NSC] [, NMXPRTY] [, NMPRIO] [, NMLOAD] 
[, JCG=job-class-group] [, ELAPTIME=nnnn] 
[, 


CPTIME=nnnnnnn)] [, LINES=nnnnnnn 


dy 


JBCLASS2 position, JOBCLASS=job-class [, XPRTY=n] 
XPRLIM={ 0 |n}] [, PRIORITY=n] [, PRLIM={ 0 |n}] 
MAXLOAD=nnn] [, { STARTED |NSTARTED}] 


[, 
[, NSC] [, NMXPRTY] [, NMPRIO] [, NMLOAD] 
[, 
[, 


JCG=job-class-group] [, ELAPTIME=nnnn] 
CPTIME=nnnnnnn)] [, LINES=nnnnnnn] ; 


dy 
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There may be several JOBCLASS and JBCLASS2 statements, but only one can be 
attributed to each job class. The JOBCLASS statement can be used for mono-letter 
job classes only (A to Z). The JBCLASS2 statement can be used for double-letter 
job classes only (AA to ZZ). 


The job class concerned (as relevant to the CLASS parameter of the JCL statement 
JOB) is defined by the first positional parameter in the JOBCLASS statement and 
by the JOBCLASS parameter in the JBCLASS2 statement. 


The first positional parameter (‘position’) in JBCLASS2 is a number ranging from | 
to 220, indicating the position of the statement occurrence. The scheduler can 
manage up to 256 classes, including 26 mono-letter job classes. 220 double-letter 
job classes may be defined in the configuration statement file. 10 more job classes 
may be defined by the system at configuration for service jobs. 


If there is no JOBCLASS statement for any given mono-letter job class, the default 
value applied by the system is as shown in Table 5-2, CONFIG Statement Default 
Values, at the end of this chapter. Except for some service job classes, if there is no 
JBCLASS2 statement for a double-letter job class, the class is not defined by the 
system. It must be created dynamically by a main operator using the job 
management command START LOAD (SLD). 


Parameters 

position (parameter specific to the JBCLASS2 statement) - 
number ranging from | to 220 indicating the position 
of the statement occurrence. 

job-class (parameter specific to the JOBCLASS statement) - an 
alphabetic character ranging from A to Z, specifying 
the mono-letter class to which the statement applies. 

JOBCLASS (parameter specific to the JBCLASS2 statement) - two 


alphabetic characters ranging from AA to ZZ, 
specifying the double-letter class to which the 
statement applies. 

Note: Job classes RA and RB are reserved for service 
jobs. They cannot be re-configured. 
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XPRTY 


XPRLIM 


PRIORITY 


PRLIM 
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a decimal digit ranging from 0 to 9, defining the 
default execution/dispatching priority for the job class. 
The parameter may be overridden by the XPRTY 
keyword of the JCL statement STEP or the GCL 
command EXEC_PG; 0 is high priority and 9 is low 
priority. The default value is that given in Table 5-1 
for mono-letter job classes (JOBCLASS statement) 
and is 9 for double-letter job classes (JBCLASS2 
statement). 


a decimal digit ranging from 0 through 9, defining the 
highest dispatching priority allowed for the class; the 
default value is 0. 


Neither the XPRTY value of the JCL statement STEP, 
nor the MDJ command from an IOF user, may exceed 
this limit. 


The value supplied for XPRTY may under no 
circumstances exceed that defined for XPRLIM. 


Note that the main operator may override the XPRLIM 
limits with the MDJ and MDLD commands. 


a decimal digit ranging from 0 through 7, defining the 
default scheduling priority for the job class; this 
parameter may be overridden by the PRIORITY 
keyword in the JCL statement JOB. 0 is high priority 
and 7 is low priority. The default value is that given in 
Table 5-1 for mono-letter job classes (JOBCLASS 
statement) and is 7 for double-letter job classes 
(JBCLASS2 statement). 


a decimal digit ranging from 0 to through 7, defining 
the limit of scheduling priority to be allowed for the 
class; the default value is 0. Neither the PRIORITY 
value of the JCL statement JOB, nor the MDJ 
command of an IOF user, may exceed this limit. This 
limit may under no circumstances be higher than that 
defined for PRIORITY. 


Note that the main operator may override the PRLIM 
limits with the MDJ and MDLD commands. 
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MAXLOAD 


STARTED / NSTARTED 


NSC 


NMXPRTY 


NMPRIO 


NMLOAD 
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a 3-digit decimal ranging from 0 through 150, defining 
the multiprogramming level within the job class; i.e., 
the maximum number of jobs in the class which may 
be in execution simultaneously. See the MULTLEV 
statement. The default value is that given in Table 5-1 
for mono-letter job classes (JOBCLASS statement) 
and is 0 for double-letter job classes (JBCLASS2 
statement). 


indicates whether the class is to be STARTED, or not 
started (NSTARTED), respectively. If both 
NSTARTED and NSC (below) are specified at the 
same time, the class becomes unavailable. STARTED 
is the default value. 


when specified, the main operator is prevented from 
using the SLD and TLD commands for the 
corresponding class. When not specified, the operator 
can use these commands for the corresponding job 
class, so that any of the GCL facilities may be used to 
manage the class and dynamically change the "started" 
or "not started" status of that class. If both 
NSTARTED and NSC are specified at the same time, 
the class is made unavailable. 


when specified, the main operator is prevented from 
using the MDLD command to modify the dispatching 
priority of the class. When not specified, the operator 
may use the MDLD command on the job class, to 
modify its default dispatching priority. 


when specified, the main operator is prevented from 
using the MDLD command to modify the scheduling 
priority of the class. When not specified, the operator 
may use the MDLD command on the job class, to 
modify its default scheduling priority. 


when specified, the main operator is prevented from 
using the MDLD command to modify the 
multiprogramming level for the class. When not 
specified, the operator may use the MDLD command 
on the job class to modify its multiprogramming level. 
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JCG 


ELAPTIME 


CPTIME 


one or two alphabetic characters ranging from A to ZZ, 
specifying the job class group to which the defined 
class belongs. The class to which the JBCLASS2 
statement applies is then a 'dependent' job class in a 
job class group in which the 'parent' job class is that 
given in the JCG parameter. The 'parent' job class 
must be defined by a JOBCLASS or JBCLASS2 
statement. 

A job class cannot be both 'parent' and 'dependent'. 
The connection is not made if JCG specifies a class 
that is already 'dependent ' in another job class group. 
The default value is none. 


IMPORTANT: Some service job classes cannot be 
attached to a job class group. 


a 4-digit decimal number that sets the default 
maximum time during which job steps, in the defined 
job class, can execute. The unit is a minute. It is 
possible to override this default value, at step 
execution time, by using the ELAPTIME parameter in 
the JCL statement STEP, or in the GCL command 
EXEC_PG. The default value (9999) means that there 
is no default limit on the elapsed time for step 
execution. No limit can be set for service job classes 
(R-Z AND RA-ZZ). 


IMPORTANT: The ELAPTIME value specified at 
step execution overrides the initially set elapsed time, 
but cannot specify 'no limit'. If a job class has an 
elapsed time limit, no step in this class can execute 
without a limit. 


a 7-digit decimal number, indicating the default 
maximum permitted CPU time for job steps running in 
the defined job class. The unit is a thousandth of a 
minute. It is possible to override this default value, at 
step execution time, by using the CPTIME parameter 
in the JCL statement STEP, or in the GCL command 
EXEC_PG. The default value (9999999) means that 
there is no default limit on CPU use. No limit can be 
set for service job classes (R-Z AND RA-ZZ). 


IMPORTANT: The CPTIME value specified at step 
execution overrides the initially set CPU time, but 
cannot specify 'no limit’. If a job class has a CPU time 
limit, no step in this class can execute without a limit. 
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LINES a 8-digit decimal number, indicating the default 
maximum number of print records that may be written 
in SYSOUT file for job steps running in the defined 
job class. It is possible to override this default value, at 
step execution time, by using the LINES parameter in 
the JCL statement STEP, or in the GCL command 
EXEC_PG. The default value (99999999) means that 
there is no default limit on number of print records. No 
limit can be set for service job classes (R-Z and RA- 
ZZ). 


IMPORTANT: The LINES value specified at step 
execution overrides the initially set LINES, but cannot 
specify “no limit’. Ifa job class has a LINES limit, no 
step in this class can execute without a limit. 


EXAMPLES (User Job Classes): 


JOBCLASS P, XPRTY=9, PRIORITY=7, MAXLOAD=3; 


This means that job class P has a dispatching priority of 9, a scheduling priority 
of 7, a multiprogramming level of 3 and is STARTED, by default. The operator 
may use TLD, SLD, and MDLD commands on this class. 


JOBCLASS H, XPRTY=9, PRIORITY=7, MAXLOAD=0; 


This means that, although job class H is started by default, since the 
multiprogramming level is 0, no class H jobs will be started unless the operator has 
issued either FJ or MDLD commands. 


JBCLASS2 JA, XPRTY=8, XPRLIM=7, NMXPRTY, JCG=A, ELAPTIME=5; 


This means that job class JA has a default dispatching priority of 8 that cannot be 
changed through the MDLD command. Steps belonging to jobs launched in this 
class cannot have a dispatching priority greater than 7 and, unless otherwise 
specified, cannot run for more than 5 minutes. JOBCLASS JA is connected to job 
class group A. The other characteristics of job class JA are the default 
characteristics of double-letter job classes, as follows: 


PRIORITY=7 

PRLIM=0 

MAXLOAD=0 

STARTED 

no limit on CPU use for step execution. 


Q 
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Remarks: 


Classes A to PZ are traditionally dedicated to user batch jobs. For these classes, the 
default values are selected to reflect the requirements of the site, but may require 
changing in the following typical situations: 


1. Several teams on the site require the same priorities for work to run in a 
multiprogramming level other than 1 (2 for instance) within a class. The 
following statements may be used: 


JOBCLASS K, XPRTY=9, PRIORITY=7, MAXLOAD=2, STARTED; 


JOBCLASS L, XPRTY=9, PRIORITY=7, MAXLOAD=2, STARTED; 


2. There are two types of job, night jobs and day jobs. Day jobs are started as 
soon as possible, but night jobs are started on operator decision, once all-day 
jobs have been completed. The statement for night jobs could be: 


JOBCLASS N, XPRTY=9, PRIORITY=7, MAXLOAD=5, NSTARTED; 
Service Job Classes 
Classes Q to QZ are generally reserved for IOF jobs. 


Classes R to Z and RA to ZZ are not directly available for user jobs. These classes 
are used by the system to spawn service jobs as follows: 


R Input readers 

RA Hardware TD_MVH job 

RB Mirrored disk REFILL jobs 

S) TNS or FEPS jobs (telecommunications monitoring, 


QMON for MCS), RAEH, IOSER, ARS, SECCL 
File transfer jobs (UFT, FTF, and SERVER2) 
DJP operators' IOF jobs and RBF 

Trace TRCCL job 


Output writers 


ed aga 


JCL translator JTRA and High Availability jobs 
(CMSR, RECOV, JRU) 


re 


GTP, VCAM, JPPC 


N 


Main operator's IOF jobs, LAEH. 
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For example: 


JOBCLASS Q, MAXLOAD=200, STARTED; 
JBCLASS2 175, QA, PRIORITY=0, XPRTY=1, MAXLOAD=20, NSTARTED, 
JCG=Q; 


In the above example: a maximum of 20 IOF users is allowed in job class QA, 
provided that no more than 200 users are connected to the whole Q job class group. 
Priorities must be specified if you want them to be similar to those of class Q. The 
main operator must issue an 'SLD QA' command before users who work in class 
QA may log on. If the main operator issues a "TLD QA' command, further QA IOF 
users are prevented from logging on. 


Remarks: 

Q Job Class The NSTARTED, NSC, and NMLOAD parameters 
enable the system administrator to monitor the 
operator's management of IOF users. 

The MAXLOAD parameter specifies the maximum 
possible number of IOF users. You should insure that 
the MAXLOAD parameter value is correctly related to 
the corresponding value of the positional parameter in 
the MULTLEYV statement. 

R Job Class It is always started. 

RB Job Class It is always defined. Its characteristics cannot be 
changed. 

S Job Class It is always started. The XPRTY and XPRILIM 
parameters are always set to 0. 

V Job Class It is always started. The NSC parameter is always set. 

W Job Class It is always started. 

X Job Class It is always started. The NSC parameter is always set. 
MAXLOAD must be set to a value greater than 3. 

Y Job Class It is always started. The NSC parameter is always set. 
The XPRTY parameter must be set to a value lower 
than 3; the default value is 2. XPRLIM is always set 
to 0. MAXLOAD must be set to a value greater than 1. 

Z Job Class It is always started. MAXLOAD must be set to a 


value greater than 1; the default value is 2. This 
parameter value may exceed 2 only if the relevant 
option has been purchased. XPRTY and XPRLIM are 
always set to 0. 


47 A2 23US 5-43 


GCOS 7 System Installation Configuration and Updating Guide 


The MAXLOAD parameter for Class Q plus the MAXLOAD parameter for Class 
Z may only exceed 40 when a large IOF configuration is installed. 


CLASS 


Table 5-1. Default Values for Mono-Letter Job Classes 
DEFAULT VALUES FOR CLASSES 
MAXLOAD /PRIORITY |XPRTY [STARTED SC |MXPRTY MPRIO /MLOAD |PRLIM |XPRLIM 


Brean sannsns nna 


100 


N<XS<CHMWOVOZEr-AC—-LOMmMVINWYS 


NAARWOAMDHYOH 


SONCONONOCONNNANNNONO RON ANANN 


ONO-—O-]-NO=|— DODO ODOODDODONAUOOO 
<<<<<<<<<<<<«<«<<<<<<«<<«<<<<~<< 


Z<<Z<<<ZZ<<<<<<<<«<«<«<«<<<~<~<< 


ZZZZ<ZZZ2Z2<<<<<<<«<<«<<<<<<~<< 


Z<Z<<Z<Z<Z<<<<<<<<<<<<<<<~< 


<<Z<<<<Z<<<«<<<<<<<<<<<<<<< 


DODD DODDDODODODOODOOOOOOO0O0O0O000 


DODD DDDDDODODODDOOOGOOOOO0O0O000 


5-44 


47 A2 23US 


CONFIG (Configuration) 


5.4.16 The JORSIZE Statement 


Purpose 


Specifies the maximum number of lines that will be printed for the JOR, by 
defining a limit for the number of lines that may ever be written to the JOR for any 
single user step. This number can be modified only by another run of CONFIG. 


Format 


JORSIZE { 500 |nnnmn} ; 


Parameters 

nnnnn is a decimal value of up to 5 digits, ranging from 1 
through 65535, specifying a maximum count for lines 
written to the JOR by any single user step using SEND 
and REPORT JCL statements, the ACCEPT/DISPLAY 
COBOL feature, or H_PUTJOR GPL primitives. No 
single user may exceed this maximum line count in his 
JOR. The default value is 500 lines. 

EXAMPLE: 

JORSIZE 50; 


The number of such user-written lines per job step is to be limited to 50. 


Q 


Remarks: 


Note that information written by the system to the JOR is not subject to this 
statement; the system is never subjected to a limit on the amount of information it 
may write. 


If user-written information exceeds the limit given in the JORSIZE statement, 
excess lines (from the corresponding step) are not written to the JOR. 
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5.4.17 The JPPCDIM Statement 


Purpose 
To select the dimension of the JPPC (of the five existing variants). 


JPPC is a system service job that allocates memory segments to TDS applications 
that use XCP2 and/or IQS. 


There are five variants of JPPC, each of which contains a certain number of 
processes (therefore, of segments). If the adequate variant is selected, JPPC does 
not use more control memory than is strictly necessary. 


JPPCDIM determines which of the five variants of JPPC is selected. 


Format 


JPPCDIM {0|n}; 


Parameters 

0 (Default value.) Specifies that the JPPC service job is 
not required. 

n A decimal digit ranging from | to 5, that identifies the 


variant of JPPC whose capacity meets the 
requirements of all the TDS applications using XCP2 
and/or IQS. 
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CONFIG (Configuration) 


1. The five variants of JPPC and their occupation of the control memory are: 


Number of 


LM Number of Number of Memory 
XCP2 : 
Processes Segments ‘ » | Occupation 
Conversations 

H_JPPC1 5 1150 350 136K 

H_JPPC2 10 2300 700 

H_JPPC3 26 5980 2400 464K 

H_JPPC4 35 8050 3500 

H_JPPC5 50 11500 5000 860K 


* These are approximate numbers, given for information only. The exact 


number of conversations supported by JPPC depends on the XCP2 
programmatic interface. 


For XCP2, each TDS session reserves a number of segments. This number 
depends on the value of the MAXTX parameter of the XCP2WKS statement 
used by NETGEN. TDS aborts if it does not obtain this number of segments. 


The number of segments reserved is at least equal to 3*MAXTX+4. More 
segments are reserved when necessary (for example, if a transaction has more 
than one conversation, or is using the PPCPI interface). 


For each IQS transaction, the user should reserve between 8 and 16 segments. 
If the initial reservation is insufficient, a warning is issued and IQS goes into 
degraded mode, using GMEM to stock data in a UFAS file. 


At the end of each TDS session, a PP03 message is sent both to the submitter 
and to the TDS JOR. This message contains, for XCP2 and/or IQS the 
numbers of JPPC segments used to the maximum. The sum total of these 
maximum values gives the limit of JPPC segments used. 


The GCL commands DS or DJ enable you to visualize which of the JPPCs are 
being processed, and the command DDIM displays the amount of memory 
occupied by the JPPC. 
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5.418 The LSYS Statement 


Purpose 


Specifies a local system name. It should be noted that the parameter LSYS in the 
NG Network Generation must use the same value. 


Format 


LSYS NAME=xxxx ; 


Parameters 


NAME introduces a 4-character alphanumeric name to be 
assigned to the local system on which CONFIG is 
being performed. If this identification parameter is 
missing (there is no LSYS statement), the default name 
DPS7 is assigned. 
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Purpose 


CONFIG (Configuration) 


Sets a limit on the maximum number of catalogs that may be known to the system 


at any one time. 


Format 


MAXCAT { 100 |nnn} ; 


Parameters 


nnn 


Remarks: 


is a decimal value of up to 3 digits, not greater than 
128, specifying the maximum number of catalogs that 
may be known concurrently in the system. The default 


value is 100. 


The system forces a minimum of 64 catalogs to avoid the risk of return code 
SYSOV when a catalog is attached. If you specify a value lower than 64, the 


message: 


MAXCAT VALUE 


Is 


L 


ESS THAN 64. 


is returned in the configuration report. 


64 


IS ASSUMED 
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5.4.20 The MAXDEF Statement 


Purpose 


Limits the maximum number of DEFINEs that may be active concurrently on the 
system. 


Format 


MAXDEF { 512 |nnnn}; 


Parameters 

nnnn is a decimal value of up to 4 digits, ranging from 100 
through 2048, to specify the maximum number of 
DEFINEs that may be active concurrently on the 
system. Certain MIs allow a value up to 6300. The 
default value is 512. 

Remarks: 


The SYS.KNODET file size (as specified through TAILOR) sets a maximum 
number of DEFINEs (NDF), according to the values specified for the MAXFILE 
and FILSHARE statements. For further details, refer to the description of the 
FILSHARE statement in this chapter. 
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Purpose 


Specifies the maximum number of files that may be active on the system at any one 
time. An active file satisfies one of the following conditions: 


e it is opened 

e it is assigned but not opened 
e itis not assigned but passed 

e itis an attached user catalog. 


System files such as SITE.CATALOG SYS.IN, SYS.OUT and SYS.URCINIT are 
not counted in this number of active files. This limit may be modified only by a 
subsequent run of CONFIG. 


Format 


MAXFILE { 512 |nmnn} ; 


Parameters 

nnnn is a decimal value of up to 4 digits, ranging from 100 
through 2048, specifying the maximum number of 
active files. Certain MIs allow a value up to 6300. 
The default value is 512. 

EXAMPLE: 


MAXFILE 1500; 


There may be no more than 1500 files active on the system at any one time. 


Q 


Remarks: 


This statement should be used when the default value is unsuitable for the 
limitations of the site, and the value should be set as low as possible compatible 
with site needs. 


If a new value is defined for MAXFILE greater than 3200 when the old value was 
less than 3200, or vice-versa, a RESTART(CLEAN) is mandatory. 
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5.4.22 The MAXIODEV Statement 


Purpose 


Specifies the maximum number of input/output devices to be allowed for any one 
station. 


Format 


MAXIODEV {42| 9 } ; 


Parameters 

MAXIODEV may be assigned with only one of two possible values, 
9 or 42. Any other value results in an error message; 
the default value is 9. 

Remarks: 


The GCL command MDST writes the input/output devices in the Input Output 
Device Table (IODT). 


The IODT tables are kept ina VMM file, with a block length of 4K if the value 9 is 
used for MAXIODEV and 8K if the value 42 is used. 


SYSADMIN determines whether more than 9 devices are required at the station. 
In most cases, the value 9 is sufficient. 
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Purpose 


Specifies the maximum number of jobs that may be known (introduced, scheduled, 
executing, or waiting for output) to the system at any one time. Both user and 
service jobs are included in this number, which cannot be modified except by a 
subsequent run of CONFIG. 


Format 


MAXJOB {500|nnnn}; 


Parameters 

nnnn is a decimal value of up to 4 digits, ranging from 10 
through 9999, defining the maximum number of jobs 
that may be known to the system. The default value 
is 500. 

EXAMPLE: 

MAXJOB 600; 


Not more than 600 jobs are to be allowed in the system at any one time. If the limit 
of 600 jobs is reached, a new job may be introduced only when an existing job is 
completed. 


Q 


Remarks: 


CONFIG automatically adds the maximum number of started jobs (the value of 
MULTLEV) to the value supplied. 


The combined values defined for MAXJOB and MULTLEV may under no 
circumstances exceed 9999; MULTLEV is explained later in this chapter. 


The active limit on the value defined for MAXJOB depends on the size of the 
SYS.PVMF{i] files. 


The following formula allows SYS.PVMF{i] file size requirements (in Megabytes) 
to be evaluated, based on the values specified for the three CONFIG statements 
MAXJOB, MULTLEV and ACTSIZE. 


PVMFSIZE(MB)=5 + 14/1024 * multlev + 16/1024 * maxjob 
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5.4.24 The MAXTAPE Statement 


Purpose 


This statement is used to set the maximum number of tape cartridges that may be 
known (either assigned or passed) to the system at any one time. 


Each volume serial number, that is each cartridge, counts as one "tape". This 
number cannot be modified except by a subsequent run of CONFIG. 


Format 


MAXTAPE { 64 |nn} ; 


Parameters 

nn is a decimal value of up to 2 digits, ranging from 1 
through 64, to define the maximum number of tape 
cartridge VSNs that may be known to the system at 
any one time. The default value is 64. 

EXAMPLE: 

MAXTAPE 12; 


Limits to 12 the number of tape cartridges that may be known at any one time to 
the system. 


Q 


Remarks: 


The number defined by this statement allows the size of the relevant segment to be 
tailored. Each tape cartridge carries an overhead of about 40 bytes of memory. 
When using this statement, therefore, make sure that the default value is not too 
high. 
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5.4.25 The MAXTASK Statement 


Purpose 


Specifies the maximum number of tasks (for user and service job processes) which 
may be executed simultaneously. This limit may be modified only by a subsequent 
run of CONFIG. 


Format 


MAXTASK { 150 |nmnn} ; 


Parameters 

nnnn is a decimal value of up to 4 digits, ranging from 1 
through 3900, to define the maximum possible number 
of tasks (for user and service job processes) which may 
be executed simultaneously. The default value is 150. 

EXAMPLE: 


MAXTASK 800; 


Up to 800 tasks may run simultaneously. 


Q 


Remarks: 


The value given with this statement should be related to that of the MULTLEV 
statement; if MULTLEV defines that no more than n jobs may be "started", a value 
of n should therefore be sufficient for the MAXTASK statement in a 
monoprocessing environment. The default value of 150 is consistent with the 
corresponding MULTLEV default value of 90 and allows for multiprocessing. 


As the MAXTASK value decreases, so does the size of resident segments. 
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Each TDS application accounts for several tasks, this number being set at TDS 
generation time with the parameter SIMULTANEITY. Each user step normally 
counts for | task. 


COBOL programs using the MCS (Message Control System) facility may have 
more than one process. The number of processes 1s specified in the TASK 
statements of the Static Linker utility. 


NOTE: 
There is no direct relation between the number of Compile Units and the 
number of processes in the resulting Load Module, since the TASK statement of 
the Static Linker utility must be used to create multi-task steps. 
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Purpose 


Controls the multiprogramming level by specifying the maximum number of jobs 
that may be "started" concurrently. To achieve this, MULTLEV defines the 
maximum number of started jobs (including service jobs); this value may only be 
changed by a subsequent run of CONFIG. 


Format 


MULTLEV nnn ; 


Parameters 

nnn is a decimal value of up to 3 digits, specifying the 
number of jobs that may be started concurrently, in the 
range 2 through 254, to define the maximum number 
of concurrently "started" jobs (service jobs + user 
jobs). The default value is 90. 

EXAMPLE: 


MULTLEV 100; 


A total of 100 service and/or user jobs may be started. 


Q 


Remarks: 
One user job may be considered as being equivalent to either: 
e a TDS application 


e an MCS application. 
On the other hand, an IOF job is one service job in Class Q. 


Each increment of the positional parameter costs an extra 47 bytes in resident 
memory. 


The multiprogramming level of Class Q limits the number of interactive users (IOF 
users in job class Q), that is, by the MAXLOAD parameter in the JOBCLASS 
statement for job class Q. 


The value specified for the MAXLOAD keyword in the JOBCLASS statement 
must be less than or equal to the value supplied for MULTLEV. 
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5.4.27 The OWCLASS Statement 


Purpose 


Specifies the default priority and media for each of the output writer classes. The 
default priority and media may be modified for a given output class, either: 


e by SYSADMIN using MNCAT commands such as CRS and MDS, which may 
be applied to any station other than MAIN (refer to the GCOS 7 System 
Administrator's Manual) 


e by the operator using the GCL command MDC with the OC option (refer to the 
GCOS 7 System Operator's Guide). 


These default priority and media values may be overridden for individual 
deliveries, either: 


e by the user specifying the relevant parameters in the batch JCL statements 
OUTVAL, SYSOUT and WRITER 


e or by the operator issuing the GCL command MDO or FO. 


Format 


OWCLASS output-class [,PRIORITY=n] [,MEDIA=media] statement 
JOBCLASS et JBCLASS2; 


Parameters 

output-class specifies the output class for which the default 
selection priority and media are to be modified. 

PRIORITY introduces a 1-digit value ranging from | through 6, 
specifying the default selection priority to be attached 
to the relevant output class. System default priorities 
are as shown in the remarks below, priority 6 being the 
lowest priority. 

MEDIA introduces a string of up to 6 alphanumeric characters, 


specifying the default output media for the class. 
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LINES 


EXAMPLES: 


OWCLASS A, PRIORITY= 


2; 


CONFIG (Configuration) 


introduces a 7-digit value ranging from 1 to 9999999, 
specifying the system default value for the maximum 
number of lines contained in the output for a given 
class. 

If this value is omitted, or if equal to 9999999, there is 
no limit to the number of lines. 

If the value is less than 1, the value 9999999 is 
assumed. 

Any job that creates output in the class concerned, and 
whose size is greater than the quota of lines indicated 
by this parameter, will be aborted with the return code 
ERLMOV. 


Dumps are not limited to this quota of lines. 


The quota of lines can be modified dynamically, 
during a GCOS session, using the command 
MODIFY CONFIGURATION. 


OWCLASS C, PRIORITY=2, MEDIA=110001; 
OWCLASS A, LINES=100000; (Maximum size of class A output is 


100000 lines) 


Q 


Remarks: 


There may be several OWCLASS statements, each specifying an output class to be 
given a new default priority and/or media 


If there is no OWCLASS statement for a given output class, the standard system 


defaults are assumed: 


Output Class Default Priority 
A 1 
B 2 
C 3 
D 4 
E 5 
F to Z 6 
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5.4.28 The OWDEVICE Statement 


Purpose 


Specifies the output classes to be started as soon as the output writer is activated 
for a specific device (from the MAIN station only) without any indication of class 
in the SOW command. These default classes may be changed only by a subsequent 


run of CONFIG. 

Format 

OWDEVICE position [, DVID=dvid] [, CLASS=output-class-list] ; 
Rules 

1. More than one OWDEVICE statement may be used. The first positional 
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parameter value of the statement determines the position of the output device 
concemed. If position n is used, positions 1, 2 ... (n - 1) must also be used, in 
any order and before or after the reference to n. 


If two statements have the same position, they must refer to the same device, 
the value for the DVID parameter being the same. This ensures that the latest 
statement is taken into account. 


Device external names must exist in the SRST; otherwise, an error is detected 
and all the following statements (in the position sense) become ineffective. 


If there is no OWDEVICE statement for a particular device in the SRST, by 
default all the output classes are started when the output writer is started on 
that device. The devices taken into account are those in the SRST suitable for 
the output writer (PR devices). 


A device may not be named in more than one OWDEVICE statement with a 
difference of position. 
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Parameters 


position 


DVID 


CLASS 


EXAMPLES: 


CONFIG (Configuration) 


is a decimal value of up to 2 digits, ranging from 1 
through 15, which enables the position of up to 15 
output devices to be set. Leading zeros are not 
allowed. 


This enables a position to be specified when there is 
more than one OWDEVICE statement (see 1. above). 


introduces the device identification of a particular 
device, such as PRO1. When an SOW operator 
command is issued, the output classes specified by the 
CLASS parameter are automatically started on this 
device. 


This name must represent a device known in the SRST 
and must represent a device suitable for the output 
writer: PRxx. 


introduces a string of up to 26 alphabetic characters, 
from A through Z, representing the classes to be started 
when the output writer is started on the device 
declared. 


Suppose that the site knows the following devices: PRO1, PRO2. 


1. No OWDEVICE statement is issued: 


When the operator 


The following output classes 


issues the command: are started on that device: 
SOW PRO1 A to Z 
SOW PRO2 A to Z 


2. The following OWDEVICE statements have been issued: 
OWDEVICE 1, DVID=PRO01, CLASS=ABCDEF; 


OWDEVICE 2, DVID=PR02, CLASS=GHIJKLMNOPORSTUVWKXYZ ; 


When the operator 


The following output classes 


issues the command: are started on that device: 
SOW PRO1 A to F 
SOW PRO2 G to Z 
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3. The following OWDEVICE statements have been issued: 


OWDEVICE 1, DVII 


D=PRO1, CLASS=ABCDEFGHIJKL; 


OWDEVICE 2, DVII 


D=PRO2, CLASS=IJKLMNOP; 


When the operator 
issues the command: 


SOW PRO1 
SOW PRO2 


The following output classes 
are started on that device: 


Ato lL 
I to P 


4. The following OWDEVICE statements have been issued: 


OWDEVICE 


lL, DVID=PR01 


Ll, CLASS=ABCD; 


OWDEVICE 1, DVID=PR01 


|, CLASS=EFGH; 


The second statement overrides the first; when the operator issues an SOW 
PRO1 command, the output classes started on that device are E, F, G, and H. 


5. Anerror would occur if the following OWDEVICE statements were issued: 


OWDEVICE 1, DVID=PR01, CLASS=ABCD; 
OWDEVICE 1, DVID=PR02, CLASS=GFGH; 


because two statements of same position attempt to refer to different devices. 


6. Anerror would occur if the following OWDEVICE statements were issued: 


OWDEVICE 1, DVI 


D=PRO1 


Ll, CLASS=ABCD; 


OWDEVICE 2, DVI 


D=PRO1 


Ll, CLASS=EFGH; 


because a single device is referred to in two statements with different 


positions. 
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Remarks: 


Suppose that the installation has only one printer, PRO1, and that output files fall 
into one of two possible categories: 


1. Output files belonging to classes A, B, C, D, E, F 
2. Output files belonging to classes G to Z. 


Output in category (i) is urgent and generally not bulky; listings are wanted as soon 
as possible. On the other hand, output files in category (ii) are lengthier and not 
urgent. It may be useful to issue the following statement: 


OWDEVICE 1, DVID=PR01, CLASS=ABCDEF ; 


So that, when the operator issues the command SOW PRO1, only urgent output will 
be printed, not output in classes G through Z. 


When the time comes to print the remaining output, the operator issues the 
following command: 


SOW PRO1 G-Z 


Similarly, if the site has two printers using different paper, and if there is a 
convention at the site to use output classes according to paper type: 


Classes A to F use paper nl 
Classes G to Z use paper n2, 


it may be convenient to use: 


OWDEVICE 1, DVID=PR01, CLASS=ABCDEF ; 
WDEVICE 2, DVID=PRO02, CLASS=GHIJKLMNOPORSTUVWKXYZ ; 


with the result that, when the operator issues the commands SOW PRO1 and SOW 
PRO2, it will not be necessary to change the paper. 
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5.4.29 The OWDFLT Statement 


Purpose 


Specifies the system defaults for the output writer parameters CLASS, 
DEVCLASS, TAPE and xBANxxx in JCL statements. 


e These defaults are taken into account when processing the CLASS and 
DEVCLASS parameters of the OUTVAL/SYSOUT/WRITER batch JCL 
statements. 


e The TAPE parameter is provided for the purposes of compatibility with much 
earlier releases, and modifies the internal format of SYSOUT tapes. This default 
may be changed only by a subsequent run of CONFIG. 


e The banner parameters include FRANNER, EBANNER and BANCHAR. 


Format 


OWDFLT CLASS={class| C }] 

[, DEVCLASS={devclass | PR/H132}] 

[, TAPE={SYSOUT|NSYSOUT}] [,FBANNER={0|1|2}] 
[, EBANNER={0|1]2}] [,BANCHAR={'xx'|'0Z'}] 
[, 
[, 


PAPERBRK=[Y|N]] [,CHARBRK=['xy|'0Z']] 
BIGCHAR=[Y|N]]; 


Parameters 

CLASS introduces the default value for the CLASS parameter 
of the JCL statements OUTVAL, SYSOUT, and 
WRITER. Ifthe CLASS parameter is not supplied, the 
system default value is C. 

DEVCLASS introduces the default device class with the attributes 


of its associated printer. If the DEVCLASS parameter: 


— is not specified, the system default value depends on 
the type of printer installed; for example, if the 
printer is a PR54, the default value of DEVCLASS 
is PR/H132. 


— is wrong, the statement is rejected. 


It is always advisable to specify the DEVCLASS 
parameter explicitly, especially if there are different 
printer types on the same site. 
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TAPE 


FBANNER 


EBANNER 


BANCHAR 


PAPERBRK 


CHARBRK 


BIGCHAR 
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CONFIG (Configuration) 


establishes whether or not the output writer is to 
employ user-defined parameters. If the user has 
written a tape without preallocating it specifically to 
use the SYSOUT mechanism, parameters for the 
Output Writer must be taken from the user program. 


The value SYSOUT allows the Output Writer to 
override user instructions (as to block size, for 
instance). NSYSOUT prevents the Output Writer from 
doing this. This parameter is only provided for reasons 
of compatibility with a much earlier release. 


User programs reading SYSOUT tapes require use of 
the NSYSOUT value. 


specifies the number of front banner pages between 
deliveries. The default value is 2; the other values 
possible are 0 or 1. 


specifies the number of end banner pages between 
deliveries. The default value is 1; the other values 
possible are 0 or 2. 


defines the two graphic symbols, enclosed within 
single quotes, to be used for printing banners. The 
default value is '0Z’. 


specifies whether or not a special line, separating two 
consecutive outputs, is printed. The default value is N 
(no special line). If set to Y, a special line is printed 
immediately after the output banner. 


defines the two graphic symbols, enclosed in single 
quotes, of which the special separating line will be 
composed. The default value is '0Z'. This parameter is 
meaningful only if PAPERBRK=Y. 


specifies whether the big characters of the banner are 
composed of the corresponding small characters, or 
not. 

The default value is N; in this case the big characters 
of the banner are composed of the first character of the 
BANCHAR parameter. 
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EXAMPLES: 


OWDFLT ; 


The default class for deliveries is to be CLASS=C; the system default output 
device is a PR/Hxxx printer, with the belt/character set/paper combination: 
110000. Ifthe output writer has to create SYSOUT tapes, it may override 
user-supplied RECFORM and BLKSIZE parameters. 


OWDFLT CLASS=D, DEVCLASS=PR/H160; 


The default class for deliveries is CLASS=D, while the system default output 
device is a PR/H160. 


OWDFLT FBANNER=0, EBANNER=0; 


No banner will be printed between deliveries, unless the user specifies a BANNER 
parameter in OUTVAL, SYSOUT or WRITER in which case default values will be 
assumed for FRANNER and EBANNER. 


OWDFLT PAPERBRK=Y CHARBRK='KX' BIGCHAR=Y; 


A special line, composed of characters 'KX", will be printed in order to separate the 
two consecutive outputs. The big characters in the banner will be composed of the 
corresponding small characters. 


Q 


Remarks: 
This statement should be used when: 


1. the installation has no PR/Hxxx printer. 


2. the installation has more than one printer and the type PR/Hxxx is not to be 
the default output device. 


the default standard belt is not suitable. 


4. acomplete application is working on SYSOUT tapes. 
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5.4.30 The PRLOG Statement 
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Purpose 


CONFIG (Configuration) 


Specifies the threshold value at which the operator is warned that the SYS.ERLOG 
file should be printed. PRLOG also specifies the associated printing options. This 
statement may be changed only by a subsequent run of CONFIG. 


Format 


PRLOG [THRESHLD={50 |nn}] [, COMMAND='ocl-request'] ; 


Parameters 


THRESHLD 


COMMAND 


introduces a decimal value of up to 2 digits, ranging 
from | through 99, to specify when the SYS.ERLOG 
file should be printed. The operator receives the 
message: 


"ELOL SYS.ERLOG xx% FULL." 
The default value is 50. 


introduces a string of a maximum of 105 characters in 
length, enclosed within single quotes, specifying a 
valid operator command to be activated whenever the 
threshold value is reached. If this parameter is not 
specified, by default the following message is sent to 
the operator: 


"ELO3 RUN PRLOG." 
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EXAMPLE: 


PRLOG THRESHLD=90; 


Q 


Remarks: 


The threshold value may be modified depending on the frequency at which the file 
contents are printed, on the file size and on the rate at which it is filled. 


The statement provides a convenient way to run a PRLOG job with the specific 
options: 


PRLOG THRESHLD=65, COMMAND='EJR PRLOG'; 


If HSSLIB of the INPUTCTL statement is not specified, the way to run PRLOG 
job is: 


PRLOG THRESHLD=65, COMMAND='EJR PRLOG, ,SYS.LIB'; 


Private PRLOG job can be in a USER library and run as: 


PRLOG THRESHLD=65, COMMAND='EJR PRLOG, , USER.LIB'; 
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5.4.31 The PRLOGC Statement 
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Purpose 


CONFIG (Configuration) 


Specifies the threshold value at which the operator is warned that the SYS.LOGC 
file should be printed. PRLOGC also specifies the associated printing options. 
This statement may be changed only by a subsequent run of CONFIG. 


Format 


PRLOGC [THRESHLD={ 50 |nn}] [, COMMAND='ocl-request'] ; 


Parameters 


THRESHLD 


COMMAND 


introduces a decimal value of up to 2 digits, ranging 
from 2 through 99, to specify when the SYS.LOGC 
file should be printed. The operator receives the 
message: 


"SYS.LOGC xx% FULL." 
The default value is 50. 


introduces a string of maximum length 105 characters 
enclosed within single quotes, to specify a valid 
operator command for activation whenever the 
threshold value is reached. If this parameter is not 
specified, by default the following message is sent to 
the operator: 


"RUN PRLOGC" 
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EXAMPLE: 


PRLOGC THRESHLD=90 ; 


Q 


Remarks: 


The threshold value may be modified depending on the frequency at which the file 
contents are printed, on the file size and on the rate at which it is filled. 


The statement provides a convenient way to run a PRLOGC job with the specific 
options: 


PRLOGC THRESHLD=65, COMMAND='EJR PRLOGC' ; 


If HSSLIB of the INPUTCTL statement is not specified, the way to run PRLOGC 
job is: 


PRLOGC THRESHLD=65, COMMAND= 


EJR PRLOGC, ,SYS.LIB'; 


Private PRLOG job can be in a USER library and run as: 


PRLOGC THRESHLD=65, COMMAND='EJR PRLOGC, ,USER.LIB'; 
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5.4.32 The QUEUED Statement 
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Purpose 


Governs the use of the Cache Mechanism for shared (but not coupled) queued 
linked files by activating or inhibiting this mechanism on Directory and BAM 
(Block Allocation Map) blocks of shared queued linked files (library organization). 


Format 


QUEUED { NCACHE |CACHE} ; 


Parameters 
CACHE specifies that the Cache Mechanism be activated. 
NCACHE ensures that the Cache Mechanism is not activated, the 


default value. 


Activation of the Cache Mechanism consumes memory but saves input-output 
activity. 
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5.4.33 The SADMOPT Statement 


Purpose 


Enables the selection of options specific to System Administration (for users 
working under the SYSADMIN project). 


Format 


SADMOPT 


Parameters 


CHKJSADM 


GCLKPROJ 
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CHKJSADM= {YES | NO} 


GCI 


GCI 


LKPROJ={YES | NO} 


LKSADM= {YES | NO} 


GCSADMOP= {YES | NO} 


GCL15BIN= {YES | NO} 


MIRROR= {YES | NO} 


SK] 


BSUJO! 


B={YES|NO}; 


Checks if a job is for system administration. 


YES: GCOS 7 will check that users running jobs for 
SYSADMIN are working under the SYSADMIN 
project. 


NO: default value. 


Note: If the project of the $JOB statement is 
SYSADMIN, the submitter's project must also be 
SYSADMIN. 


YES: GCL procedures that contain the LOCK keyword 
in the PROC statement can be modified in maintain 
commands by any user working under the project. 


NO (default value): modification of these procedures is 
limited to the user compiling them. 
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GCLKSADM 


GCSADMOP 


GCLISBIN 


MIRROR 


SKBSUJOB 
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CONFIG (Configuration) 


YES: users of the SYSADMIN project will have the 
same rights in maintain commands on locked GCL 
procedures as the user who has compiled them. 


NO (default value): users working under the 
SYSADMIN project are not allowed to modify locked 
GCL procedures (LOCK option in PROC). 


Checks SYSADMIN access to Main Operator 
commands through EXDIR. 


YES: users under the SYSADMIN project have the 
same rights as the Main Operator. 


NO (default value): users under the SYSADMIN 
project are normal IOF users. 


YES: authorize to skip from 3 to 15 binaries libraries 
in the SEARCH path. 

NO: default value. (MWINLIB BIN clears up to 3 
libraries). 


Defines the Mirror Disks activity. 


YES: makes the Mirror Disks facility available on the 
system. Disk mirroring, and activities on mirrored 
disks are possible after a RESTORE, RESTART 
(COLD), provided that the SITE.MIRLOG file exists. 


NO (default value): the Mirror Disks facility will not 
be available on the system. 


For further details, refer to the Mirror Disks User's 
Guide. 


Specifies whether right blanks in values are to be 
skipped: 


YES: right blanks in values are skipped when the field 
JOB_SKIP_ BLANK is not specified in the 
JOB_DESCRIPTION parameter of CALL "SUBJOB". 


NO: right blanks in values are kept when the field 
JOB SKIP BLANK is not specified in the 
JOB_DESCRIPTION parameter of CALL "SUBJOB". 
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5.4.34 The SECOPT Statement 


Purpose 


Used in a network environment to select options specific to security. The version 
of SECUR'ACCESS referred to is V2. 


Format 


SECOPT 


Parameters 


SA7LOGON 


SA7ADMIN 


SA7NOCSL 
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SA7LOGON= 


SA7ADMIN= 


SA7NOCSL= 


{YES | NO} 
{YES | NO} 


{YES | NO} 


NETSEC= {YES | NO} 


CHKPW= { YES | NO} 


ERASE= {YES |NO}; 


YES 


: users' rights to access TDS/IOF applications are 


checked at connection time by SECUR'ACCESS. 


NO (default value): users' access rights are checked at 
connection time by GCOS 7. 


YES 


: user administration is performed by 


SECUR'ACCESS. 


NO (default value): user administration is performed 
by SYSADMIN through catalog management 


(MN 
YES 


CAT). 


: the rights of users to access the local system 


console are checked by GCOS 7. 


NO (default value): the rights of users to log on to the 


local 


system console are checked by 


SECUR'ACCESS. 
Meaningful only when SA7LOGON=YES. 
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NETSEC 


CHKPW 


ERASE 


CONFIG (Configuration) 


Network security. 


YES: connections always go through the front-end 
processor, which performs security checks using 
LACS (Logiciel d'Accés et de Contréle de Sécurité) 
software, via the front-end processor. A special site 
(called BCLS) must be created for this purpose and, in 
the NETGEN directive, the path to this site must be 
declared as going through the front-end processor and 
having access to LACS. 

The front-end processor can be either the Datanet or 
the CNP 7. 


NO (default value): local connections are checked by 
GCOS 7. 


For more details, refer to Networks: Overview and 
Generation and the GCOS 7 System Administrator's 
Manual. 


YES: in order to improve system security GCOS 7 
verifies, on the acceptor site, the requestor's password 
and the application name for all connection requests to 
GCOS 7 applications (IOF, TDS, UFT, DJP, 
RPMOS...). 


GCOS 7 checks that the requestor's identity (USER, 
PROJECT, PASSWORD and BILLING - if a billing 
check is validated at site catalog level) is registered in 
the SITE.CATALOG file. 


GCOS 7 also checks that the requested application 
name is in the list of authorized applications in the 
SITE.CATALOG file, for the current USER and 
PROJECT. 


NO (default value): on the acceptor site, GCOS 7 
checks the requestor's password and the application 
name for connection requests to certain applications 
(such as IOF and TDS), but not for others (such as 
UFT and DJP). 


YES: after a file is deallocated, the entire data space 
that was allocated to the file is overwritten with zeros. 
Thus, data that was in the file prior to deallocation 
cannot be read. This applies to all files. 


NO (default value): the files are not physically erased 
after deallocation. 
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5.4.35 The VCAMSCN Statement 


Purpose 


Tailors VCAM structures according to the maximum number of DSA, ISO, and 
GXTI session connections required. 


GXTI (GCOS Extended Transport Interface) allows applications to access the 
transport layer directly, without using the session layer. 


Format 


VCAMSCN [MAXISO={ 0 |nnnn} J 
[MAXDSA={2500|nnnn}] 
[MAXTE={ 100|nnnn}]; 


Parameters 

MAXISO maximum number of ISO connections. 
MAXDSA maximum number of DSA connections. 
MAXTE maximum number of GXTI connections. 

nonn the sum of the 3 connection sessions (ISO, DSA, 


GXTI) must not be greater than 14000 and there must 
be at least one DSA session. 
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5.4.36 The VOLORG Statement 
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Purpose 


On a site that supports both VBO and FBO disks, VOLORG defines the disk types 
that are authorized on that site. 


Format 


VOLORG {VBO|FBO|ALL}; 


Parameters 

VBO Only VBO disks are allowed on the site. 

FBO Only FBO disks are allowed on the site. 

ALL Both VBO and FBO disks are allowed on the site. 
Remark: 


This option is to be used: 


e by the VOLPREP utility, to prohibit the creation of an unauthorized disk type 


e to adjust GCL menus to the site configuration. 
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5.4.37 The XAS Statement 


Purpose 


For UFAS-EXTENDED files, XAS specifies the number of extended buffers. 


Format 


XAS [XBUF={8192|nnnnn}]; 


Parameters 


nnnnn 5-digit decimal value, ranging from | to 32640, that 
specifies the maximum number of extended buffers. 
The value specified is rounded up to the nearest 
multiple of 256. The default value is 8192. 
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5.5 Default Values of CONFIG Statement 
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Table 5-2. CONFIG Statement Default Values (1/2) 


MINEVERY 15 
POSIT 1 FFFFFFFF 
MYSELF FFFFFFFF 


DUMPACT COMMAND 
PREVIOUS 


FILEOPT COMPTS 
MNTWORK 
CTFIRST 
LASTDATE 
USESITE 
CTUNLOAD 


FILSHARE 

GAC LONGWAIT 
LOCKSIZE 
NBLOCKID 


INPUTCL 
NTERM 
SJREADER NTERM 
HSLLIB SYS.HSLLIB 
HOABORT NO 


JOBCLASS 
JBCLASS2 PRLIM 0 
STARTED YES 
ELAPTIME 9999 
CPTIME 9999999 
|JPPCDIM [POSIT] OO 
|MAXIODEV_[POsiT] [9 
|MULTLEV | PosiT] ~— 90 
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Table 5-2. 


CONFIG Statement Default Values (2/2) 


OWCLASS 


OWDEVICE 


OWDFLT 


PRLOG THRESHLD 
COMMAND 


PRLOGC 


POSIT 1=A 
POSIT 1=B 
POSIT 1=C 
POSIT 1=D 
POSIT 1=E 
POSIT 1=F-Z 
MEDIA 
POSIT 1 
DVID 
CLASS 
CLASS 
DEVCLASS 
TAPE 
BIGCHAR 
PAPERBRK 
CHARBRK 
FBANNER 
EBANNER 
BANCHAR 


THRESHLD 
COMMAND 


PRIORITY=1 
PRIORITY=2 
PRIORITY=3 
PRIORITY=4 
PRIORITY=5 
PRIORITY=6 
110000 
(1,15) 

XXXX 

A-Z 

C 

PR/H132 
SYSOUT 

N 

N 

0Z 

2 


QUEUED POSIT 1 YCACHE 


SADMOPT 
SECOPT 


SITEOPT POSIT1 


VCAMSCN 


VOLOG POSIT 1 
XBUF 
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CHKJSADM 
GCLBIN 
GCLKPROJ 
GCLKSADM 
GCSADMOP 
MIRROR 
SKSUBJOB 
SA7LOGON 
SA7ADMIN 
SA7NOCSL 
NETSEC 
CHKPW 
ERASE 


MAXISO 
MAXDSA 
MAXTE 


1 
0Z 
50 
50 
N 
NO 


00000000 
0 

2500 

100 


8192 
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5.6 Output Listings 


At the end of a CONFIG run, the following listings and messages are produced: 


e Hardware device configuration listing 
e Explicit configuration commands 

e Memory parameters 

e Scheduling Parameter listing 

e Configuration Class listing 

e Effective configuration commands 

e Successful Completion message 


e Unsuccessful Completion message(s). 
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5.6.1 Explicit Configuration Commands 


Configuration commands supplied by the user are printed out under the heading: 


*** EXPLICIT CONFIGURATION COMMANDS (PROVIDED BY USER) *** 


Each statement is numbered; the numbers are referred to in any subsequent error 
message. Table 5-3 shows a typical example of the listing. 


Table 5-3. Typical Explicit Configuration Command Listing 


**x** EXPLICIT CONFIGURATION COMMANDS (PROVIDED BY USER) **** 


0001 DUMPACT COMMAND = 'EJ DUMPACT:USER.JCLLIB'; 
0002 JORSIZE 200; 

0003 DEVTRACE ABN, ATN, WARN, ALRM; 

0004 MAXTASK 400; 


0005 BJSIMU 100; 


0006 MULTLEV 140; 


0007 LSYS NAME = SST1; 


0008 DUALSYS AABBCCDD; 


5.6.2 Memory Parameters 


Information pertinent to these parameters is printed under the heading "MEMORY 
PARAMETERS": 


MEMORY PARAMETERS 

IMPORTANT IF YOU HAVE CHANGED THE PARAMETER VALUE OF BKST PLM, SM, 
CKPT, UNITSZ AS COMPARED WITH THE SYSTEM CURRENT VALUES, THE NEW 
VALUE OF THESE PARAMETERS IS TAKEN INTO ACCOUNT ONLY WITH RESTORE 
+ RESTART (CLEAN) . 


ESTIMATED PERMANENT BKST1 NEEDS: 10 MEGA-BYTES. 
ESTIMATED PERMANENT BKST2 NEEDS: 38 MEGA-BYTES. 
ESTIMATED TEMPORARY BKST* NEEDS: 83 MEGA-BYTES. 
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5.6.3 Scheduling Parameter Listing 


CONFIG (Configuration) 


Asummary of scheduling parameters is printed out under the heading 
SCHEDULING PARAMETERS. A typical printout is shown in Table 5-4. 
Information for this listing is extracted from the MAXJOB and MULTLEV 


statements. 


Table 5-4. 


Typical Scheduling Parameter Listing 


SCHEDULING PARAMETERS 


MAXIMUM NUMBER OF KNOWN JOBS : 640 
MAXIMUM NUMBER OF STARTED JOBS : 140 


5.6.4 Configuration Class Listing 


A job class status listing is printed out, giving the following information: 


CLASS 
MAXLOAD 


PRIORITY 
XPRTY 


STARTED 


sc 


MXPRTY 
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gives the name of the job class. 


gives the number of multiprogramming levels within 
the job class. 


gives the scheduling priority attached to the job class. 
gives the dispatching priority attached to the job class. 


"Y" means the job class is started; blank means the job 
class is not started. 


"Y" means that the SLD and TLD GCL commands are 
allowed in this job class. Blank means that these 
commands are not allowed; i.e., the NSC parameter 
has been used in the corresponding JOBCLASS 
statement. 


"Y" means that the operator may change the job class's 
dispatching priority with the MDLD GCL command. 
Blank means that the operator cannot change the 
class's priority; i.e., the NNXPRTY parameter has 
been used in the corresponding JOBCLASS statement. 
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5.6.5 


MPRIO 


MLOAD 


PRLIM 


XPRLIM 


"Y" means that the operator may change the job class's 
scheduling priority with the MDLD GCL command. 
Blank means that the operator cannot change the 
class's priority; i.e., the NMPRIO parameter has been 
used in the corresponding JOBCLASS statement. 


"Y" means that the operator may change the job class's 
multiprogramming level with the MDLD GCL 
command. Blank means that the operator cannot 
modify the class's multiprogramming level; i.e., the 
NMLOAD parameter has been used in the 
corresponding JOBCLASS statement. 


shows the limit of the scheduling priority allowed for 
the class; "0" is the default value. 


indicates the limit of the dispatching priority allowed 
for the class; "0" is the default value. 


Effective Configuration Commands 


Under the heading: 


*xX*X*X*XEEFPECTIVE COMMANDS OF CONFIG-STEP IDENT : xx 


is shown the entire set of commands effective for the configuration being a merge 
of explicit configuration commands as supplied by the user with all the default 
values (commands with default values assigned to their parameters). In practice, 
certain statements will be found in the listing which have not been included in the 
CONFIG statements detailed in this chapter; this is because these statements 
contain no user-'selectable' features and thus are of no concern. Below is an 
example listing of commands effective for a configuration (but excluding any 
‘non-selectable' features, for the sake of brevity and clarity). 


xxkx* EFFECTIVE COMMANDS OF CON F IG - STEP IDENT : 22 

ACCOUNT ALL; 

JOBCLASS A, XPRTY=9,PRIORITY= 7, XPRLIM=0, PRLIM=0, MAXLOAD=1, STARTED; 
JOBCLASS B, XPRTY=9, PRIORITY=7, XPRLIM=0, PRLIM=0, MAXLOAD=1, STARTED; 
JOBCLASS C, XPRTY=9, PRIORITY=7, XPRLIM=0, PRLIM=0, MAXLOAD=1, STARTED; 
JOBCLASS D, XPRTY=5, PRIORITY=1, XPRLIM=0, PRLIM=0, MAXLOAD=1, STARTED; 
JOBCLASS E, XPRTY=4, PRIORITY=2, XPRLIM=0, PRLIM=0, MAXLOAD=1, STARTED; 
JOBCLASS F, XPRTY=7, PRIORITY=3, XPRLIM=0, PRLIM=0, MAXLOAD=1, STARTED; 
JOBCLASS G, XPRTY=9, PRIORITY=4, XPRLIM=0, PRLIM=0, MAXLOAD=1, STARTED; 
JOBCLASS H, XPRTY=0, PRIORITY=6, XPRLIM=0, PRLIM=0, MAXLOAD=1, STARTED; 
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JOBCLASS 
JOBCLASS 
JOBCLASS 
JOBCLASS 
JOBCLASS 
JOBCLASS 
JOBCLASS 
JOBCLASS 
JOBCLASS 
JOBCLASS 


Aro vO 242 8 YF HR GH 


JOBCLASS S, 


JOBCLASS T, 
JOBCLASS U, 


JOBCLASS V, 
JOBCLASS W, 


JOBCLASS X, 


JOBCLASS Y, 
JOBCLASS Z, 


MAXJOB 1000; 


+MAXTASK 800; 


,MULTLEV 140; 
MAXIODEV 42; 
OWCLASS A, 
OWCLASS B, 
OWCLASS C, 
OWCLASS D, 
OWCLASS E, 
OWCLASS F, 
OWCLASS G, 
OWCLASS H, 
OWCLASS I, 
OWCLASS J, 
OWCLASS K, 
OWCLASS L, 
OWCLASS M, 
OWCLASS N, 
OWCLASS 0, 
OWCLASS P, 
OWCLASS Q, 
OWCLASS R, 
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XPRTY=9, PRIORITY=7, XPRLIM=0, 
XPRTY=0, PRIORITY=6, XPRLIM=0, 
XPRTY=9, PRIORITY=7, XPRLIM=0, 
XPRTY=9, PRIORITY=7, XPRLIM=0, 
XPRTY=9, PRIORITY=7, XPRLIM=0, 
XPRTY=9, PRIORITY=7, XPRLIM=0, 
XPRTY=9, PRIORITY=7, XPRLIM=0, 
XPRTY=9, PRIORITY=7, XPRLIM=0, 
XPRTY=1, PRIORITY=0, XPRLIM=0, 
XPRTY=1, PRIORITY=0, XPRLIM=0, 
NMXPRTY; 

XPRTY=0, PRIORITY=0, XPRLIM=0, 
NMXPRTY, NMPRIO, NMLOAD; 


XPRTY=1, PRIORI 
NMXPRTY; 

XPRTY=0, PRIORI’ 
NMXPRTY, NMPRIO, 
XPRTY=2, PRIORI’ 
XPRTY=0, PRIORI’ 
NMXPRTY, NMPRIO; 
PRIORITY=1, MEDIA=I1 
PRIORITY=2, MEDIA=11 
PRIORITY=3, MEDIA=I1 
PRIORITY=4, MEDIA=11 
PRIORITY=5, MEDIA=TI1 
PRIORITY=6, MEDIA=11 
PRIORITY=6, MEDIA=11 
PRIORITY=6, MEDIA=[11 
PRIORITY=6, MEDIA=11 
PRIORITY=6, MEDIA=[11 
PRIORITY=6, MEDIA=11 
PRIORITY=6, MEDIA=11 
PRIORITY=6, MEDIA=11 
PRIORITY=6, MEDIA=11 
PRIORITY=6, MEDIA=11 
PRIORITY=6, MEDIA=11 
PRIORITY=6, MEDIA=11 
PRIORITY=6, MEDIA=11 


[Y=7, XPRLIM=0, 
ry=0, XPRLIM=0, 


[Y=7, XPRLIM=0, 
ry=0, XPRLIM=0, 


ry=0, XPRLIM=0, 


[Y=7, XPRLIM=0, 
[y=0, XPRLIM=0, 


10000; 
10000; 
10000; 
10000; 
10000; 
10000; 
10000; 
10000; 
10000; 
10000; 
10000; 
10000; 
10000; 
10000; 
10000; 
10000; 
10000; 


10000; 


vu UU U U Uv DU DU Uo UD 
AA A A A A A AAD 


Bs) 


A A 


zs) 


zs) 


LIM=0, 
LIM=0, 
LIM=0, 
LIM=0, 
LIM=0, 
LIM=0, 
LIM=0, 
LIM=0, 
LIM=0, 
LIM=0, 


LIM=0, 


LIM=0, 
LIM=0, 


LIM=0, 
LIM=0, 


LIM=0, 


LIM=0, 


LIM=0, 


MAX] 
MAXI 
MAXI 
MAXI 
MAXI 
MAXI 
MAXI 
MAX] 
MAX] 
MAXI] 


MAXI 


MAXI 
MAXI 


MAXI 
MAXI 


MAXI 


MAX] 
MAXI 
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LOAD=1, STARTED; 

LOAD=1, STARTED; 

LOAD=1, STARTED; 

LOAD=1, STARTED; 

LOAD=1, STARTED; 

LOAD=1, STARTED; 

LOAD=1, STARTED; 

LOAD=40, STARTED; 
LOAD=100, STARTED, NMPRIO; 
LOAD=6, STARTED, NSC, 
LOAD=12, STARTED, NSC, 
LOAD=6, STARTED, NMXPRTY; 
LOAD=6, STARTED, NMXPRTY, 
LOAD=1, STARTED; 

LOAD=8, STARTED, NSC, 
LOAD=1, STARTED, NSC, 
LOAD=6, STARTED, NMXPRTY; 
LOAD=4, STARTED, NSC, 
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OWCLASS 
OWCLASS 
OWCLASS 
OWCLASS 
OWCLASS 
OWCLASS 
OWCLASS 
OWCLASS 


OW 


OW 
OW 
OW 
OW 
OW 
OW 
OW 
OW 
OW 
OW 
OW 
OW 
OW 
OW 
OW 


DEVICE 
DEVICE 
DEVICE 
DEVICE 
DEVICE 
DEVICE 
DEVICE 
DEVICE 
DEVICE 
DEVICE 
DEVICE 
DEVICE 
DEVICE 
DEVICE 
DEVICE 


DFLT CLASS=C, 


RIORITY=6, MEDIA=110000; 
RIORITY=6, MEDIA=110000; 
RIORITY=6, MEDIA=110000; 
RIORITY=6, MEDIA=110000; 
RIORITY=6, MEDIA=110000; 
RIORITY=6, MEDIA=110000; 
RIORITY=6, MEDIA=110000; 
RIORITY=6, MEDIA=110000; 


NK xeM SB GGHN 


UU vu vy Dy Uo 


DEVCLASS=PR, TAPE=SYSOUT, FBANN 


RST 
RST 
RST 
RST 
RST 
RST 
RST 
RST 
RST 


ER=2, EBANN 


UVWXYZ ; 
UVWXYZ ; 
UVWXYZ ; 
UVWXYZ ; 
UVWXYZ ; 
UVWXYZ ; 
UVWXYZ ; 
UVWXYZ ; 
UVWXYZ ; 


1, DVID=xxxx, CLASS=ABCDEFGHIJKLMNOPQ. 
2, DVID=xxxx, CLASS=ABCDEFGHIJKLMNOPQ. 
3, DVID=xxxx, CLASS=ABCDEFGHIJKLMNOPQ. 
4, DVID=xxxx, CLASS=ABCDEFGHIJKLMNOPQ. 
5, DVID=xxxx, CLASS=ABCDEFGHIJKLMNOPQ. 
6, DVID=xxxx, CLASS=ABCDEFGHIJKLMNOPQ 
7, DVID=xxxx, CLASS=ABCDEFGHIJKLMNOPQ. 
8, DVID=xxxx, CLASS=ABCDEFGHIJKLMNOPQ 
9, DVID=xxxx, CLASS=ABCDEFGHIJKLMNOPQ. 
10, DVID=xxxx, CLASS=ABCDEFGHIJKLMNOPQRSTUVWXYZ; 


11, DVID=xxxx, CLASS=ABCDEFGHIJKLMNOPQRSTUVWXYZ; 
12, DVID=xxxx, CLASS=ABCDEFGHIJKLMNOPQRSTUVWXYZ; 
13, DVID=xxxx, CLASS=ABCDEFGHIJKLMNOPQRSTUVWXYZ; 
14, DVID=xxxx, CLASS=ABCDEFGHIJKLMNOPQRSTUVWXYZ; 
15, DVID=xxxx, CLASS=ABCDEFGHIJKLMNOPQRSTUVWXYZ; 


MAXFILE 2048; 


MAXTAPE 


64; 


FILSHARE 141; 


ACTSIZE 


200; 


-JORSIZE 200; 


.DEVTRACE ABN, WARN, ATN, ALARM; 


PRLOG THRESHLD=50, COMMAND=NO; 


MAXDEF 512; 


.DUALSYS AABBCCDD, MYSELF=FFFFFFFF; 


. BOSIMU 


100; 


. DUMPACT COMMAND=EJR DUMPJOB :USER.JCLLIB; 


GAC LONGWAIT=40, LOCKSIZE=128, NBLOCKID=1024; 


5-86 
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BANCHAR=02Z; 
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INPUTCTL DKMEDIA=CHB, JTRA=TERM, SJREADER=TERM, SLLIB=SYS.HSLLIB; 


MAXCAT 128; 


DJPCTL MAXTFSIT=4; 


PRLOGC THRESHLD=50, COMMAND=NO; 


-LSYS NAME=SST1; 


QUEUED NCACHE; 


(_ ) COMMAND BY DEFAULT : NO EXPLICIT PARAMETER, NO OVERRIDDEN PARAMETER. 
(.) SOME EXPLICIT PARAMETER PROVIDED TO STEP, NO OVERRIDDEN PARAMETER. 
(+) SOME EXPLICIT PARAMETER VALUE OF THIS COMMAND HAS BEEN OVERRIDDEN. 


UNDEFINED PARAMETERS/COMMANDS ARE NOT PRINTED 


SUCCESSFUL CONFIGURATION : FILE SYS.SYSTEM HAS BEEN UPDATED 
TO RUN CONFIGURED SYSTEM, USE ISL-OPTIONS : RESTORE, RESTART (COLD) 


1(2)3 IMPORTANT: 
Network configuration could be mandatory 
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5.6.6 Successful Completion Message 


If no errors or warnings have been detected, the following message is output on the 
listing and at the operator's console: 


SUCCESSFUL CONFIGURATION: FILE SYS.SYSTEM HAS BEEN UPDATED. 
TO RUN CONFIGURED SYSTEM, USE ISL-OPTIONS: 
RESTORE, RESTART (COLD) 


IMPORTANT: 
Network configuration could be mandatory 


5S) 


NOTES: 


1. After a restore session following a CONFIG run, all devices except those 
listed implicitly or explicitly in ILO1 are in HOLD state. To use these 
devices, an RDV (release device) command is necessary. 


2. If CONFIG is being executed on the running Set and the CONFIG 
statement LSYS is being used to specify a new Local SYStem name, the 
telecommunications network must be modified, by rerunning the network 
generation utility NG. 


5.6.7 Unsuccessful Completion Message(s) 


Each error message is preceded by one or three stars, depending on the severity of 
the error. 
* One star indicates a warning; execution continues. 


** Three stars indicate a fatal error; execution is aborted. 
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5.6.8 Hardware Configuration Listing 


An example of a configuration extracted from the hardware configuration table is 
shown in the following pages. 


Every hardware component configured in the installation is identified by its 
user-specified SRST "name" which the system associates with: 


e its LDN (logical device number) for use by the software 
e its "path" for the use of hardware. 

The "path" is in the hexadecimal format XYZZ, where: 

e X is the IOC and set to 0 

e Y is the "physical channel" 

e ZZ is the "logical channel". 


The hardware configuration is arbitrary, the SRST "name" and the "path" varying 
from installation to installation. 


In the example, LN12 of LDN 08 is followed by LN.. of LDN 09, in the same way 
as LN11 0A is followed by LN.. of LDN OB. 


This is possible when LN11 and LN12 are to be used for VIP and TRANSPAC 
communications. 


Typical Hardware Device Configuration Listing 


KREKKKKKKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKKKEEEK 


*kkKKGCOST KKK 
KKK H CONFIG KKK 
RARE VERSION: 92.00 DATED: APR 14, 1986 aed 


KKKKKKKKKKKKKKKKKKKOVSOTHM CONFIGURATION REPORT * * * ¥ * KKK KKK KKK KKK 


KREKKKKKKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KEEKEK 


ADDITIONAL INFO: 6 8 16 21 22 24 

001 UC30 8400 002 UC80 ACO0 
003 uc90 9800 004 uCc40 8C00 
005 UC20 CBOO 006 uCcO1 FEOO 
007 TCO2 CAOO 008 TCO1 2200 
009 TC56 B900 OOA TC52 A900 
00B TC42 8900 00Cc TES. A400 
00D TCO4 C500 OOE TCO3 B400 
OOF MC06 C100 010 MCO02 C000 
011 MCcO4 C400 012 MCC9 C900 
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013 MCO1 C800 014 MC13 2100 
015 MC1 2000 016 MC24 2400 
017 MC15 2900 018 MC12 2800 
019 MCM BCOO O1A MCL3 A000 
01B MCK4 A200 01C MCL2 9E00 
01D MCK 9C00 01E MCM4 8200 
O1F ccol C300 020 CC02 C200 
021 cel 9000 022 CC12 2A00 
023 MF 1 FEO9 024 MFO1 FEO8 
025 MF 23 CBO03 026 MF22 CBO2 
027 MF'2, CBO1 028 MF'82 ACO02 
029 MF8 ACcO1 O2A MF92 9802 
02B MFO 9801 02C MF42 8C02 
02D MF4 8C01 02E MF'3 3 8408 
02F MF32 8409 030 MF31 8401 
031 DIO CBOE 032 CT58 B903 
033 CT57 B902 034 CT56 B901 
035 cT04* B40A 035 cTO4* C50A 
036 cT03* B409 036 CTO3* C509 
037 cT02* B402 037 CTO2* C502 
038 cTo1* B401 038 cTo1* C501 
039 CT51 A402 O3A CT50 A401 
03B CT43 8902 03C CT42 8901 
03D CT53 A902 03E CT52 A901 
O3F LT28 CB1F 040 LT28 CB20 
041 LT27 CB1D 042 LT27 CB1E 
043 LT26 CB1B 044 LT26 CB1C 
045 LT25 CB19 046 LT25 CB1A 
047 LT24 CB17 048 LT24 CB18 
049 LT23 CB15 O4A LT23 CB16 
04B LT22 CB13 04C LT22 CB14 
04D LT21 CB11 O4E LT21 CB12 
O4F LT86 ACOD 050 LT86 ACOE 
051 LT85 ACOB 052 LT85 ACOC 
053 LT84 ACO9 054 LT84 ACOA 
055 LT83 ACO7 056 LT83 ACO08 
057 LT82. ACO05 058 LT82 AC06 
059 LT81. AC03 O5A LT81. ACcO4 
05B LT96 980D O5C LT96 980E 
05D LT95 980B O5E LT95 980C 
O5F LT94 9809 060 LT94 980A 
061 LT93 9807 062 LT93 9808 
063 LT92 9805 064 LT92 9806 
065 LT91 9803 066 LT91 9804 
067 LT48 8C11 068 LT48 8C12 
069 LT47 8COF O6A LT47 8C10 
06B LT46 8COD 06C LT46 8COE 
06D LT45 8COB 06H LT45 8CO0C 
O6F LT44 8C09 070 LT44 8COA 
O71 LT43 8C07 072 LT43 8C08 
073 LT42 8C05 074 LT42 8C06 
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075 LT41. 
077 LNO8 
079 LNO6 
07B LNO4 
07D LNO2 
O7F CL3E 
081 CL3C 
083 CL3A 
085 CL38 
087 CL36 
089 CL34 
08B CL32 
08D CL2F 
O8F CL2D 
091 CL2B 
093 CL29 
095 CL27 
097 CL25 
099 CL23 
09B CL21 
09D CL1E 
O9F CL1Cc 
OA1 CL1A 
0A3 CL18 
OA5 CL16 
OA7 CL14 
OA9 CL12 
OAB CLOF 
OAD CLOD 
OAF CLOB 
OB1 CLO9 
OB3 CLO7 
OB5 CLO5 
OB7 CLO3 
OBO CLO1 
OBB PR21 
OBC MTO4* 
OBD MTO3* 
OBE MT02* 
OBF mMT01* 
O0CcO MS16* 
0C1 MS15* 
0C2 Ms14* 
0C3 MS13* 
0Cc4 MS12* 
0c5 Ms11* 
O0C6 MS10* 
OC7 MSO9* 
0Cc8 MS24* 
0c9 MS23* 
OCA MS22* 
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8C03 
FEO7 
FEO5 
FEO3 
FEO1 
C30E 
C30C 
C30A 
C308 
C306 
C304 
C302 
C20F 
C20D 
C20B 
C209 
C207 
C205 
C203 
C201 
900E 
900C 
900A 
9008 
9006 
9004 
9002 
2A0F 
2A0D 
2A0B 
2A09 
2A07 
2A05 
2A03 
2A01 
CBO7 
CAO04 
CA03 
CA02 
CAO1 
C408 
C407 
C406 
C405 
C404 
C403 
C402 
C401 
C108 
C107 
C106 
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8C04 
FEO6 
FEO4 
FEO2 
C30F 
C30D 
C30B 
C309 
C307 
C305 
C303 
C301 
C20E 
C20C 
C20A 
C208 
C206 
C204 
C202 
900F 
900D 
900B 
9009 
9007 
9005 
9003 
9001 
2A0E 
2A0C 
2A0A 
2A08 
2A06 
2A04 
2A02 
8402 
2204 
2203 
2202 
2201 
2108 
2107 
2106 
2105 
2104 
2103 
2102 
2101 
2908 
2907 
2906 
2905 
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fo) 
OUD 
POO 


u 


Oo 
Oo 


Oo 
ice) 


SeCoOCoCoOoOoO OOOO OOO OOOO OOOO 
oO 0 
No) oO 


oo 
rE) 
Oo Ty 


0001 
0002 
0003 
0004 
0005 
0006 
0007 
0008 
0009 
0010 


MS21* C105 OCC MS20* 
MS20* C104 OCD MS19* 
MS19* C103 OCE MS18* 
MS18* C102 OCF MS17* 
MS17* C101 ODO MSO7* 
MSO7* 2807 ODO MSO7* 
MSO7* C807 OD1 MS06* 
MS06* 2806 OD1 MS06* 
MSO06* C806 OD2 MSO5* 
MS05* 2805 OD2 MSO05* 
MS05* C805 OD3 MSO4* 
MSsO4* 2804 OD3 MSO4* 
MsO4* C804 OD4 MSO03* 
MS03* 2803 OD4 MS03* 
MS03* C803 OD5 MSO2* 
MSO02* 2802 OD5 MSO2* 
MSO02* C802 OD6 MSO1* 
MSsO1* 2801 OD6 MSO1* 
MSsO1* C801 OD7 MSM4* 
MSM4* 8204 OD8 MSM3 * 
MSM3 * 8203 OD9 MSM2* 
MSM2* 8202 ODA MSM1* 
MSM1* 8201 ODB MSL4* 
MSL4* A004 ODC MSL3* 
MSL3* A003 ODD MSL2* 
MSL2* A002 ODE MSL1* 
MSL1* A001 ODF MSK4* 
MSK4* A204 OEO MSK3* 
MSK3* A203 OE1 MSK2* 
MSK2* A202 OE2 MSK1* 
MSK1* A201 OE3 MS32+ 
MS31+ C903 OE5 MS30+ 
MS29+ c901 OE7 MS28+ 
MS27+ 2403 OE9 MS26+ 
MS25+ 240 


(.) MULTI LC DEVICE 
(*) MULTI PC DEVICE 
(+) SHARABLE DEVICE 


ACCOUNT ALL; 

ACTSIZE 800; 

BJSIMU 64; 

DJPCTL MAXTFSIT=6; 

DUMPACT COMMAND='EJ DUMPACT, , SITE.CONFIG; '; 
FILSHARE 150; 
GAC LONGWATT=150, LOCKSIZE=320,NBLOCKID=4095; 
INPUTCTL SJREADER=NTERM, JTRA=NTERM, HSLLIB=SYS 
JOBCLASS A,MAXLOAD=6 , XPRTY=2, PRIORITY=2 ; 
JOBCLASS B,MAXLOAD=6 , XPRTY=3 , PRIORITY=3 ; 
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. HSLLIB; 


2904 
2903 
2902 
2901 
2007 
C007 
2006 
C006 
2005 
C005 
2004 
C004 
2003 
C003 
2002 
C002 
2001 
Cool 
BCO4 
BCO3 
BCO2 
BCO1 
9EO04 
9E03 
9E02 
9EO1 
9C04 
9C03 
9C02 
9CO01 
C904 
C902 
2404 
2402 
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0011 
0012 
0013 
0014 
0015 
0016 
0017 


OBCLASS M,MAXLOAD=1,XPRTY=3 , PRIORITY=3 , NMLOAD; 
OBCLASS Q,MAXLOAD=50; 

OBCLASS R,MAXLOAD=4; 

OBCLASS Z,MAXLOAD=20; 

ORSIZE 5000; 

PPCDIM 2; 

iSYS NAME=BCC9 ; 


Gy Gy Ce ey. Cy 54 


0018 
0019 


MAXCAT 128; 
MAXDEF 512; 


0020 
0021 
0022 
0023 
0024 
0025 
0026 
0027 
0028 
0029 
0030 
0031 
0032 
0033 
0034 


MAXIMUM NUMBER OF KNOWN JOBS 


MAXFILE 5000; 

MAXJOB 2356; 

MAXTAPE 64; 

MAXTASK 1000; 

MULTLEV 254; 

OWDFLT DEVCLASS=PR/H136; 

PRLOG COMMAND='EJ PRLOG, ,SYS.HSLLIB'; 
PRLOGC COMMAND='EJ PRLOGC, ,SYS.HSLLIB'; 
QUEUED NCACHE; 
SADMOPT MIRROR=YES GCLKSADM=YES; 
SITEOPT 00001040; 

VOLORG ALL; 

XAS XBUF=8192; 


SECOPT SA7LOGON=NO SA7ADMIN=NO SA7NOCSL=YES CHKPW=YES; 


DUALSYS 89500028; 


MAXIMUM NUMBER OF STARTED JOBS : 254 
MAXIMUM NUMBER OF CLASSES : 256 
CLASSES CONFIGURATION 


2610 


CONFIG (Configuration) 


CLASS MAXLOAD PRIORITY XPRTY STARTED SLD MXPRTY MPRIO MLOAD PRLIM XPRLIM 
ELAPTIME CPTIME JCG 


OVOBZESAPNGCHTAODAAAUVAW Pe 


6 2 2 ag Ye 6 oY, Y Y 
6 3 3 Y Y Y Y Y 
1 7 9 Y Y Y Y Y 
if. 1 5 ¥ Y Y Y Y 
2 4 Y Y Y Y ¥. 
3 vi Y Y Y x Y 
4 9 Y Y Y x ¥. 
6 0 Y Y Y x ¥. 
7 9 Y Y yY x ¥. 
6 0 Y Y Y x ¥. 
7 9 Y Y Y x ¥: 
7 9 Y Y yY Ba Y 
3 3 Y Y Y x 
7 9 Y Y Y Ba Y 
1 7 9 Y Y Y Y ¥. 
40 7 9 Y Y Y Y Y 
50 0 al av Y Y Y 
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OOO COOOCOCOCOOOOCOAOCOCO Oo 


COOCOCOCOCOCOOCOCOCOOCOCOOOO fd 


9999 
9999 
9999 
9999 
9999 
9999 
9999 
9999 
9999 
9999 
9999 
9999 
9999 
9999 
9999 
9999 
9999 


9999999 
9999999 
9999999 
9999999 
9999999 
9999999 
9999999 
9999999 
9999999 
9999999 
9999999 
9999999 
9999999 
9999999 
9999999 
9999999 
9999999 
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R 4 0 1 na Me BG 0 
S 12 0 0 Y 0 
T 6 7 2 NG Y Me Y 0 
U 6 0 1 Y Y Y 0) 
V E 7 9 ng Y ng ng 0 
W 8 0 al Y x ¥ 0) 
x 4 0 0 ng 0 
'Y. 6 a 2 Y Na Y 0 
Z 20 0 0 Y Y 0 
RB 175 0 1 Y 0 


rFODOOCOCCCOCCOO 


9999999 
9999999 
9999999 
9999999 
9999999 
9999999 
9999999 
9999999 
9999999 
9999999 


.JOBCLASS A,XPRTY=2, PRIORITY=2 , XPRLIM=0, PRLIM=0 , MAXLOAD=6 , JCG=, ELAPTIME=9999, 


CPTIME=9999999, STARTED; 


.JOBCLASS B,XPRTY=3, PRIORITY=3 , XPRLIM=0, PRLIM=0 , MAXLOAD=6 , JCG=, ELAPTIME=9999, 


CPTIME=9999999, STARTED; 


JOBCLASS C,XPRTY=9, PRIORITY=7, XPRLIM=0 , PRLIM=0 , MAXLOAD=1, JCG=, ELAPTIME=9999, 


CPTIME=9999999, STARTED, NSC; 


JOBCLASS D,XPRTY=5, PRIORITY=1, XPRLIM=0 , PRLIM=0 , MAXLOAD=1, JCG=, ELAPTIME=9999, 


CPTIME=9999999, STARTED; 


JOBCLASS E,XPRTY=4, PRIORITY=2 , XPRLIM=0 , PRLIM=0 , MAXLOAD=1, JCG=, ELAPTIME=9999, 


CPTIME=9999999, STARTED; 


JOBCLASS F,XPRTY=7, PRIORITY=3 , XPRLIM=0, PRLIM=0 , MAXLOAD=1 , JCG=, ELAP' 


CPTIME=9999999, STARTED; 


JOBCLASS G,XPRTY=9, PRIORITY=4, XPRLIM=0 , PRLIM=0 , MAXLOAD=1,JCG 


CPTIME=9999999, STARTED; 


TIME=9999, 


, ELAPTIME=9999, 


JOBCLASS H, XPRTY=0, PRIORITY=6, XPRLIM=0 , PRLIM=0 , MAXLOAD=1, JCG=, ELAPTIME=9999, 


CPTIME=9999999, STARTED; 


JOBCLASS I,XPRTY=9, PRIORITY=7, XPRLIM=0 , PRLIM=0 , MAXLOAD=1, JCG=, ELAPTIME=9999, 


CPTIME=9999999, STARTED; 


JOBCLASS J,XPRTY=0, PRIORITY=6, XPRLIM=0 , PRLIM=0 , MAXLOAD=1, JCG=, ELAPTIME=9999, 


CPTIME=9999999, STARTED; 


JOBCLASS K,XPRTY=9, PRIORITY=7, XPRLIM=0 , PRLIM=0 , MAXLOAD=1, JCG=, ELAPTIME=9999, 


CPTIME=9999999, STARTED, NSC; 


JOBCLASS L,XPRTY=9, PRIORITY=7, XPRLIM=0, PRLIM=0 , MAXLOAD=1, JCG=, ELAPTIME=9999, 


CPTIME=9999999, STARTED, NSC; 


.JOBCLASS M, XPRTY=3, PRIORITY=3 , XPRLIM=0 , PRLIM=0 , MAXLOAD=1, JCG=, ELAPTIME=9999, 


CPTIME=9999999, STARTED, NMLOAD ; 


JOBCLASS N, XPRTY=9, PRIORITY=7, XPRLIM=0 , PRLIM=0 , MAXLOAD=1, JCG=, ELAPTIME=9999, 


CPTIME=9999999, STARTED, NSC; 


JOBCLASS O,XPRTY=9, PRIORITY=7, XPRLIM=0, PRLIM=0 , MAXLOAD=1, JCG=, ELAPTIME=9999, 


CPTIME=9999999, STARTED, NSC; 


JOBCLASS P,XPRTY=9, PRIORITY=7, XPRLIM=0 , PRLIM=0 , MAXLOAD=40 , JCG=, ELAPTIME=9999, 


CPTIME=9999999, STARTED; 


-JOBCLASS Q,XPRTY=1,PRIORITY=0, XPRLIM=0, PRLIM=0 , MAXLOAD=50, JCG=, ELAPTIME=9999, 


CPTIME=9999999, STARTED, NMPRIO; 


.JOBCLASS R,XPRTY=1,PRIORITY=0, XPRLIM=0, PRLIM=0 , MAXLOAD=4 , JCG=, ELAPTIME=9999, 


CPTIME=9999999, STARTED, NSC, NMXPRTY; 


JOBCLASS S,XPRTY=0, PRIORITY=0, XPRLIM=0, PRLIM=0 , MAXLOAD=12 , JCG=, ELAPTIME=9999, 


CPTIME=9999999, STARTED, NSC, NMXPRTY, NMPRIO, NMLOAD; 
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JOBCLASS T,XPRTY=2, PRIORITY=7, XP. 
CPTIME=9999999, STARTED 
U, XPRTY=1, PRIORITY=0, XPRLIM 
CPTIME=9999999, STARTED 
JOBCLASS V,XPRTY=9, PRIORITY=7, XPRLIM 
CPTIME=9999999, STARTED 
JOBCLASS W,XPRTY=1,PRIORITY=0,XPRLIM 
CPTIME=9999999, STARTED 


JOBCLASS 


+JOBCLASS 


RLIM 
, NMXPRTY; 


,NSC; 


CONFIG (Configuration) 


=0, PRLIM=0 , MAXLOAD=6 , JCG=, ELAPTIME=9999, 


=0, PRLIM=0 , MAXLOAD=6 , JCG=, ELAPTIME=9999, 
, NMXPRTY , NMPRIO; 
=0, PRLIM=0 , MAXLOAD=1 , JCG=, ELAPTIME=9999, 


=0, PRLIM=0 , MAXLOAD=8 , JCG=, ELAPTIME=9999, 
, NSC, NMXPRTY ; 


X,XPRTY=0, PRIORITY=0 , XPRLIM=0 , PRLIM=0 , MAXLOAD=4 , JCG=, ELAPTIME=9999, 


CPTIME=9999999, STARTED, NSC, NMXPRTY, NMPRIO, NMLOAD; 


JOBCLASS Y,XPRTY=2, PRIORITY=7, XPRLIM=0 , PRLIM=0 , MAXLOAD=6 , JCG=, ELAPTIME=9999, 


.JOBCLASS 


CPTIME=9999999, STARTED, NSC, NMXPRTY; 


Z,XPRTY=0, PRIORITY=0, XPRLIM=0 , PRLIM=0 , MAXLOAD=20 , JCG=, ELAPTIME=9999, 


CPTIME=9999999, STARTED, NSC, NMXPRTY, NMPRIO; 


.MAXJOB 2356; 
.MAXTASK 1000; 
-MULTLEV 254; 


OWCLASS 
OWCLASS 
OWCLASS 
OWCLASS 
OWCLASS 
OWCLASS 
OWCLASS 
OWCLASS 
OWCLASS 
OWCLASS 
OWCLASS 
OWCLASS 
OWCLASS 
OWCLASS 
OWCLASS 
OWCLASS 
OWCLASS 
OWCLASS 
OWCLASS 
OWCLASS 
OWCLASS 
OWCLASS 
OWCLASS 
OWCLASS 
OWCLASS 
OWCLASS 


MAXIODEV 42; 


A,PRIORITY=1, 


MEDTIA=110000, 


B, PRIORITY=2 , MEDIA=110000,L 
C, PRIORITY=3 , MEDIA=110000,L 
MEDTIA=110000,L 
MEDTA=110000,L 
MEDTIA=110000,L 
MEDIA=110000,1 
MEDTIA=110000,L 


D, PRIORITY=4, 
E, PRIORITY=5, 
F,PRIORITY=6, 
G, PRIORITY=6, 
H, PRIORITY=6, 
I, PRIORITY=6, 
J, PRIORITY=6, 
K, PRIORITY=6, 
L, PRIORITY=6, 
M, PRIORITY=6, 
N, PRIORITY=6, 
O, PRIORITY=6, 
P, PRIORITY=6, 
Q, PRIORITY=6, 


MEDIA=110000, 
MEDIA=110000, 
MEDTIA=110000, 
MEDIA=110000, 
MEDTIA=110000, 
MEDIA=110000, 
MEDTIA=110000, 
MEDIA=110000, 
MEDIA=110000, 


R, PRIORITY=6, 
S,PRIORITY=6, 
T, PRIORITY=6, 
U, PRIORITY=6, 
V,PRIORITY=6, 
W, PRIORITY=6, 
X, PRIORITY=6, 
Y, PRIORITY=6, 
Z,PRIORITY=6, 


MEDIA=110000, 
MEDIA=110000, 
MEDIA=110000, 
MEDIA=110000, 
MEDIA=110000, 
MEDIA=110000, 
MEDIA=110000, 
MEDIA=110000, 
MEDIA=110000, 


LINES=9999999; 


LINES=9999999; 


LINES=9999999; 


LINES=9999999; 


LINES=9999999; 


LINES=9999999; 


LINES=9999999; 


LINES=9999999; 


INES=9999999; 


INES=9999999; 


INES=9999999; 


INES=9999999; 


INES=9999999; 


INES=9999999; 


INES=9999999; 


INES=9999999; 


LINES=9999999; 


LINES=9999999; 


LINES=9999999; 


LINES=9999999; 


LINES=9999999; 


LINES=9999999; 


LINES=9999999; 


LINES=9999999; 


LINES=9999999; 


LINES=9999999; 


.OWDFLT CLASS=C, DEVCLASS=PR/H136,TAPE=SYSOUT, FBANNER=2 , EBANNER=1,BANCHAR=0Z, 
PAPERBRK=N, CHARBRK=0Z, BIGCHAR=N; 


OWDEVICE 
OWDEVICE 2,DVID=XXXX, CLASS=ABCDEFGHIJKLMNOPQRSTUVWXYZ ; 
OWDEVICE 3,DVID=XXXxX, CLASS=ABCDEFGHIJKLMNOPOQRSTUVWXYZ ; 
OWDEVICE 4,DVID=XXXX, CLASS=ABCDEFGHIJKLMNOPQRSTUVWXYZ ; 
OWDEVICE 5, DVID=XXXxX, CLASS=ABCDEFGHIJKLMNOPORSTUVWXYZ ; 


1, DVID=XXXX , CLASS=ABCDEFGHIJKLMNOPQRSTUVWXYZ ; 
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OWDEVICE 6,DVID=XXXX, CLASS=ABCDEFGHIJKLMNOPOQRSTUVWXYZ ; 
OWDEVICE 7,DVID=XXXxX, CLASS=ABCDEFGHIJKLMNOPORSTUVWXYZ ; 
OWDEVICE 8, DVID=XXXX, CLASS=ABCDEFGHIJKLMNOPQRSTUVWXYZ ; 
OWDEVICE 9,DVID=XXXX, CLASS=ABCDEFGHIJKLMNOPOQRSTUVWXYZ ; 
OWDEVICE 10,DVID=XXxXX , CLASS=ABCDEFGHIJKLMNOPORSTUVWXYZ ; 


0 

OWDEVICE 11,DVID=XXxxX, CLASS=ABCDEFGHIJKLMNOPORSTUVWXYZ ; 
OWDEVICE 12,DVID=XXxXX, CLASS=ABCDEFGHIJKLMNOPORSTUVWXYZ ; 
OWDEVICE 13,DVID=XXxXX, CLASS=ABCDEFGHIJKLMNOPORSTUVWXYZ ; 
OWDEVICE 14,DVID=XXxXX, CLASS=ABCDEFGHIJKLMNOPORSTUVWXYZ ; 
OWDEVICE 15,DVID=XXxXxX, CLASS=ABCDEFGHIJKLMNOPORSTUVWXYZ ; 
.MAXFILE 5000; 
.MAXTAPE 64; 
.FILSHARE 150; 
-ACTSIZE 800; 
-JORSIZE 5000; 
.PRLOG THRESHLD=50,COMMAND=EJ PRLOG, , SYS.HSLLIB; 
.MAXDEF 512; 
+DUALSYS 89500028,MYSELF=89500029; 
.BJSIMU 64; 
. DUMPACT COMMAND=EJ DUMPACT, , SITE.CONFIG; ; 
.GAC LONGWAIT=150 , LOCKSIZE=320, NBLOCKID=4095; 
. INPUTCTL DKMEDIA=JCL, JTRA=NTERM, SJREADER=NTERM, HSLLIB=SYS .HSLLIB, HOABORT=NO ; 
.MAXCAT 128; 
. SITEOPT 00001040; 
.DJPCTL MAXTFSIT=6,MINEVERY=15; 
.PRLOGC THRESHLD=50,COMMAND=EJ PRLOGC, , SYS.HSLLIB; 
.LSYS NAME=BCC9; 

.XAS XBUF=8192; 

.QUEUED NCACHE; 

DEFORG VBO; 

.VOLORG ALL; 

VCAMSCN MAXTSO=0 ,MAXDSA=2500,MAXTE=100; 

.SECOPT SA7LOGON=NO, SA7ADMIN=NO, CHKPW=YES , NETSEC=NO, SA7NOCSL=YES , ERASE=NO; 
.JPPCDIM 2; 
. SADMOPT CHKJSADM=NO,GCLKPROJ=NO , GCLKSADM=YES , GCSADMOP=NO, MIRROR=YES, 
GCL1I5BIN=NO, SKBSUJOB=NO; 

FILEOPT COMPTS=PREVIOUS , MNIWORK=NO, CTFIRST=NO, LASTDATE=YES , USESITE=NO, 
CTUNLOAD=NO ; 
(_) COMMAND BY DEFAULT : NO EXPLICIT PARAMETER, NO OVERRIDDEN PARAMETER. 
(.) SOME EXPLICIT PARAMETER PROVIDED TO STEP, NO OVERRIDDEN PARAMETER. 
(+) SOME EXPLICIT PARAMETER VALUE OF THIS COMMAND HAS BEEN OVERRIDDEN. 
UNDEFINED PARAMETERS/COMMANDS ARE NOT PRINTED 


SUCCESSFUL CONFIGURATION : FILE SYS.SYSTEM HAS BEEN UPDATED 
TO RUN CONFIGURED SYSTEM, USE ISL-OPTIONS : RESTORE, RESTART (COLD) 
IMPORTANT : NETWORK CONFIGURATION COULD BE MANDATORY 
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5.6.9 Error Messages 


There are two kinds of error message: 


1. General Error Messages. These are numbered messages which do not always 
signal errors as such (e.g., 0012). The messages are printed in numerical 
sequence. 


2. Specific Error Messages. These messages refer to a statement name. 
Messages are printed in alphabetical sequence of statement names. 


5.6.9.1 General Error Messages 
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Error 0000: UNSUCCESSFUL CONFIGURATION PROCESS 
Meaning 
Due to severe errors, the CONFIG run was not completed. 


Error 0001: UNABLE TO OPEN SYS.SYSTEM 

Meaning 

The SYS.SYSTEM file could not be opened. 

Action 

Check that a SYS.SYSTEM file exists on the master system volume. 


Error 0002: UNABLE TO READ INPUT FILE 
Meaning 
1/O error while reading the configuration statement file. 


Error 0003: PREMATURE END OF STREAM 

Meaning 

'End of File' on the configuration statement file has been reached. 
Action 

Correct the last statement - a semicolon has been omitted. 


Error 0004: INVALID SEPARATOR AFTER PARAMETER VALUE 
Meaning 
Self-explanatory. 


Error 0005: ILLEGAL SEPARATOR SEQUENCE 
Meaning 
An illegal set of separators has been encountered; e.g., keyword=, , . 


Error 0006: UNABLE TO CLOSE INPUT FILE 
Meaning 
The configuration statement file could not be closed. 


Error 0007: UNABLE TO READ SYS.SYSTEM 
Meaning 
1/0 error while reading SYS.SYSTEM file. 
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Error 0008: UNABLE TO CREATE A WORK SEGMENT 
Meaning 
Error internal to CONFIG. 


Error 0009: ON STATEMENT statement-name NO VALID SEPARATOR 
BEFORE PROTECTED STRING. 

Meaning 

The statement identified contains ...=ZZ'string’. 

Action 

This should be written, ...='ZZ string’. 


Error 0010: ON STATEMENT statement-name EMPTY PROTECTED STRING 
Meaning 

The statement identified contains an empty string. 

Action 

Omit COMMAND parameter or complete argument, if statements are DUMPACT 
or PRLOG. 

Omit BANCHAR parameter or complete argument, if statement is OWDFLT. 


Error 0011: ON STATEMENT statement-name NO VALID SEPARATOR 
AFTER PROTECTED STRING. 

Meaning 

The statement identified contains ...='string'ZZ. 

Action 

This should be written ...='string ZZ’. 


Error 0012: NO USER SUPPLIED CONFIGURATION STATEMENT 
Meaning 
No user statements were taken into account during the CONFIG run. 


Error 0013: ON STATEMENT statement-name UNKNOWN STATEMENT NAME 
Meaning 

The statement identified contains an unknown statement name. 

Action 

Correct the statement concerned. 


Error 0014: ON STATEMENT statement-name ILLEGAL SEPARATOR 
AFTER FIRST SUBVERB'S NAME 

Meaning 

The statement identified contains an illegal separator after the first positional 

parameter. 


Error 0015: ON LINE line-number UNKNOWN SUBVERB'S NAME 
Meaning 
The first positional parameter value of the identified statement is unknown. 


Error 0016: ON STATEMENT statement-name KEYWORD/SIV NOT FOUND 
Meaning 

In the statement identified, a mandatory keyword parameter or self-identifying 
value is missing, or an unknown keyword has been used. 
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Error 0018: ON STATEMENT statement-name PRESENCE OF EXCLUSIVE SIVs 
Meaning 

In the statement identified, two or more mutually-exclusive self-identifying values 
have been used; e.g., STARTED and NSTARTED 


Error 0019: ON STATEMENT statement-name ILLEGAL SEPARATOR AFTER 
AN SIV 

Meaning 

In the statement identified, an illegal separator has been used after a self- 

identifying value. 


Error 0020: ON STATEMENT statement-name PARAMETER DUPLICATION 
Meaning 

In the statement identified, a parameter has been used more than once; e.g., 
STARTED and STARTED. 


Error 0021: ON STATEMENT statement-name ILLEGAL SEPARATOR AFTER A 
KEYWORD 

Meaning 

In the statement identified, an illegal separator has been used after a keyword. 


Error 0022: ON STATEMENT statement-name ILLEGAL STATEMENT / 
KEYWORD NAME (>8 CHARACTERS) 


Meaning 
A statement or keyword name is longer than 8 characters. 


Error 0023: ON STATEMENT statement-name ILLEGAL PARAMETER TYPE 
Meaning 
In the statement identified, a parameter has been specified which is not applicable. 


Error 0024: ON STATEMENT statement-name TOO LARGE PARAMETER VALUE 
Meaning 

In the statement identified, the value of a parameter exceeds the maximum 
permitted size. 


Error 0025: ON STATEMENT statement-name DUPLICATE STATEMENT 
Meaning 
The statement identified, has already been used in the configuration statement set. 


Error 0026: ON STATEMENT statement-name MANDATORY ARGUMENT MISSING 
Meaning 

In the statement identified, an argument introduced by the keyword specified has 
been omitted. 


Error 0028: ON STATEMENT statement-name SEPARATOR FOUND 
INSTEAD OF STATEMENT NAME 


Meaning 
Self-explanatory. 
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Error 0029: ON STATEMENT statement-name STATEMENT WITHOUT 
PARAMETER 


Meaning 
Self-explanatory. 


Error 0059: UNABLE TO CREATE LARGE WORK SEGMENT 
Meaning 
A request for creation of a large segment has not been performed. 


Error 0060: UNABLE TO MODIFY LARGE SEGMENT SIZE 
Meaning 
A request for modification of a large segment has not been performed. 


Error 0071: TOO MANY PARAMETERS 
Meaning 
Check the explicit configuration commands; some might be duplicated. 


Error 0090: IMPORTANT : SYS.IUF FILE NOT FOUND 
Meaning 
The SYS.IUF standard file has not been found. 


Error 0091: IMPORTANT : USER LAST CONFIGURATION COMMANDS HAVE 
NOT BEEN SAVED 
Meaning 
An error has occurred during saving of the user's explicit configuration commands. 


Error 0099: CONFIG COMMAND SAVE : UNABLE TO OPEN OUTPUT SUBFILE 
Meaning 

The subfile to contain the user's explicit configuration commands cannot be 
created. 


Error 0100: CONFIG COMMANDS SAVE, UNABLE TO READ INPUT FILE 
COMMANDS 

Meaning 

The explicit configuration commands submitted by the user cannot be read. 


Error 0101: CONFIG COMMANDS SAVE : SYS.IUF FILE OVERFLOW 
Meaning 
The SYS.IUF file is full. 


Error 0102: CONFIG COMMANDS SAVE : UNABLE TO WRITE IN OUTPUT 


SUBFILE 
Meaning 
The user's explicit configuration commands cannot be recorded in a SYS.IUF 
subfile. 
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5.6.9.2 Specific Error Messages 
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ERROR IN STATEMENT ACTSIZE: LIMIT FOR SIZE=2000 BLOCKS 
Meaning 
The value of ACTSIZE exceeds the legal limit of 2000. 


ERROR IN STATEMENT GAC; WRONG PARAMETER VALUE IN GAC 

Meaning 

Incorrect values for one or more of the GAC parameters, have been specified; 1.e., 
LOCKSIZE, LONGWAIT and/or NBLOCKID. 


ERROR IN STATEMENT "JOBCLASS job-class, MAXLOAD;" EXCEEDS NUMBER 
OF JOBS 

Meaning 

The value of MAXLOAD in JOBCLASS exceeds the limit on the maximum 
number of jobs. 


ERROR IN STATEMENT "JOBCLASS n, XPRTY;" LIMIT FOR DISPATCHING 
PRIORITY=9 

Meaning 

The value of XPRTY in JOBCLASS exceeds the range of dispatching priority 
values. 


ERROR IN STATEMENT "JOBCLASS n, PRIORITY;" LIMIT FOR SCHEDULING 
PRIORITY: 7 

Meaning 

The value of PRIORITY in JOBCLASS exceeds the range of scheduling priority 
values. 


ERROR IN STATEMENT "JOBCLASS n, NSC;" CLASS BECOMES UNAVAILABLE 
SINCE NOT STARTED AND SC NOT ALLOWED 

Meaning 

Both NSC and NSTARTED have been specified in JOBCLASS. 


ERROR IN STATEMENT "JOBCLASS;" PRIORITY LIMIT DOES NOT FIT WITH 
PRIORITY VALUE OF THE CLASS 

Meaning 

The values of PRIORITY and PRLIM in JOBCLASS are not correctly related. 


ERROR IN STATEMENT "JBCLASS2 position, JOBCLASS;" JOB CLASS NOT IN 
THE AA-ZZ RANGE 

Meaning 

The value of JBCLASS2 is out of the AA-ZZ range. 


ERROR IN STATEMENT "JBCLASS2 position, JOBCLASS;" JOB CLASS 
ALREADY EXISTS 

Meaning 

The class given for job-class (JOBCLASS parameter) has already been defined. 
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ERROR IN STATEMENT "JBCLASS2 position, JOBCLASS;" CONFIGURATION 
NOT ALLOWED FOR THE SPECIFIED JOB CLASS 

Meaning 

The class given for job-class (JOBCLASS parameter) is a service job-class whose 
characteristics cannot be changed. 


ERROR IN STATEMENT "JBCLASS2 position, JCG;" JOB CLASS GROUP NOT 
IN THE A-ZZ RANGE 

ERROR IN STATEMENT "JOBCLASS job-class, JCG;" JOB CLASS GROUP NOT 
IN THE A-ZZ RANGE 

Meaning 

The value of JCG, in the JOBCLASS/JBCLASS2 statements, is out of the A-ZZ 
range. 


ERROR IN STATEMENT "JBCLASS2 position, JCG;" JOB CLASS GROUP 
UNKNOWN 
ERROR IN STATEMENT "JOBCLASS job-class, JCG;" JOB CLASS GROUP 
UNKNOWN 

Meaning 

The job class given for JCG is neither defined by a JOBCLASS statement nor by a 
JBCLASS2 statement. 


ERROR IN STATEMENT "JBCLASS2 position, JCG;" JOB CLASS GROUP 
ALREADY CONNECTED 
ERROR IN STATEMENT "JOBCLASS job-class, JCG;" JOB CLASS GROUP 
ALREADY CONNECTED 

Meaning 

In the JOBCLASS/JBCLASS2 statement, the job class given for JCG is already 
connected to a job class group. It cannot, itself, become a job class group. 


ERROR IN STATEMENT "JBCLASS2 position, JCG;" CONNECTION NOT 
ALLOWED FOR THIS JOB CLASS 

ERROR IN STATEMENT "JOBCLASS job-class, JCG;" CONNECTION NOT 
ALLOWED FOR THIS JOB CLASS 

Meaning 

In the JOBCLASS/JBCLASS2 statement, the job class defined by the current 
statement is a service job class that cannot be connected to a job class group. 


ERROR IN STATEMENT "JBCLASS2 position, ELAPTIME;" LIMIT FOR 
ELAPTIME=9999 

ERROR IN STATEMENT "JOBCLASS job-class, ELAPTIME;" LIMIT FOR 
ELAPTIME=9999 

Meaning 

In the JOBCLASS/JBCLASS2 statement, the value of ELAPTIME is negative, or 
exceeds 9999 (9999 meaning that there is no limit for step execution time). 
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ERROR IN STATEMENT "JBCLASS2 position, ELAPTIME;" PARAMETER NOT 
ALLOWED FOR THIS JOB CLASS 

ERROR IN STATEMENT "JOBCLASS job-class, ELAPTIME;" PARAMETER NOT 
ALLOWED FOR THIS JOB CLASS 

Meaning 

In the JOBCLASS/JBCLASS2 statement, the job class defined by the current 
statement is a service job class for which no limit to step execution time can be set. 


ERROR IN STATEMENT "JBCLASS2 position, CPTIME;" LIMIT FOR 
CPTIME=9999999 

ERROR IN STATEMENT "JOBCLASS job-class, CPTIME;" LIMIT FOR 
CPTIME=9999999 

Meaning 

In the JOBCLASS/JBCLASS2 statement, the value of CPTIME is negative, or 
exceeds 9999999 (9999999 meaning that there is no limit for CPU use in a step). 


ERROR IN STATEMENT "JBCLASS2 position, CPTIME;" PARAMETER NOT 
ALLOWED FOR THIS JOB CLASS 

ERROR IN STATEMENT "JOBCLASS job-class, CPTIME;" PARAMETER NOT 
ALLOWED FOR THIS JOB CLASS 

Meaning 

In the JOBCLASS/JBCLASS2 statement, the job class defined by the current 
statement is a service job class for which no limit to step execution time can be set. 


ERROR IN STATEMENT "JORSIZE;" LIMIT FOR SIZE: 10000 RECORDS 
Meaning 
The value of JORSIZE exceeds the limit of 10000 records. 


ERROR IN STATEMENT "MAXTODEV;" INCORRECT MAXIODEV PARAMETER 9 
ASSUMED 

Meaning 

An incorrect value has been specified for MAXIODEV. The default value of 9 has 
been assumed. 


ERROR IN STATEMENT "MAXJOB POSITIONAL1;" LIMIT FOR MAXIMUM NUMBER 
OF JOBS: 9999 

Meaning 

The value of MAXJOB exceeds the limit of 9999. 


ERROR IN STATEMENT "MAXTASK;" LIMIT FOR NUMBER OF TASKS: 3900 
Meaning 
The value of MAXTASK exceeds the limit of 3900. 


ERROR IN STATEMENT "OWCLASS;" INVALID OUTPUT CLASS PRIORITY, 
NORMAL DEFAULT VALUE ASSUMED 

Meaning 

The value of PRIORITY in OWCLASS, is not within the permitted range; the 
default value has therefore been assumed. Refer to the description of the 
OWCLASS statement, and to the summary of CONFIG Statement Default Values. 
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ERROR IN STATEMENT "OWCLASS;" UNACCEPTABLE DEFAULT MEDIA 
Meaning 

The argument of MEDIA in the OWCLASS statement is incorrect. The default 
value is assumed. 


ERROR IN STATEMENT "OWDEVICE;" XXXX NOT PRESENT AT INSTALLATION 
Meaning 

The argument of DVID (XXXX) in OWDEVICE was not found when the SRST 
was searched; media XX XX is not available. 


ERROR IN STATEMENT "OWDFLT;" DEVICE CLASS ERROR 

Meaning 

The argument of DEVCLASS in OWDFLT is incorrect. The default value, taken 
from the SRST, has therefore been used. 


ERROR IN STATEMENT "OWDFLT;" UNACCEPTABLE "OWDFLT; " 

Meaning 

The default values do not match the devices. The argument of DEVCLASS in 
OWDEFLT is incorrect according to the device in the SRST. 


ERROR IN STATEMENT "OWDFLT;" ERRONEOUS BANNER n ASSUMED 
Meaning 

The values of either FRANNER and/or EBANNER in OWDFLT are incorrect. 
Value 1 is assumed for FRANNER and value 2 for EBANNER. 


ERROR IN STATEMENT "OWDFLT;" INCORRECT TAPE PARAMETER. TAPE= 
SYSOUT ASSUMED 

Meaning 

The argument of TAPE in OWDFLT must be either SYSOUT or NSYSOUT. The 
default option, SYSOUT, has been used. 


ERROR IN STATEMENT "PRLOG THRESHLD;" THRESHLD VALUE MUST BE LESS 
THAN 100 AND GREATER THAN 0 

Meaning 

An incorrect value has been specified for THRESHLD in PRLOG. 


ERROR IN STATEMENT "JOBCLASS Q, MAXLOAD" EXCEEDS MAX NUMBER OF IOF 
JOBS 

Meaning 

The appropriate option has not been purchased; the number of IOFs cannot 

exceed 40. 


ERROR IN STATEMENT "MAXJOB;" UNABLE SET SYSLOAD TABLE TO ITS 
APPROPRIATE SIZE 

Meaning 

System problem, or limit for MAXJOB is too high. 
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ERROR IN STATEMENT "MAXJOB;" UNABLE TO SET MAXSIZE OF SYSLOAD FROM 
MAXJOB 

Meaning 

System problem, or limit for MAXJOB is too high. 


ERROR IN STATEMENT "MULTLEV"; LARGE IOF NOT PURCHASED, NB OF IOF 
CANNOT EXCEED 40 

Meaning 

Despite the general level of multiprogramming having been fixed at greater than 
40, the number of active IOFs may never exceed 40 if the appropriate option is not 
present on the system. 


ERROR IN STATEMENT "MULTLEV"; UNABLE TO SET JET TABLE TO ITS 
APPROPRIATE SIZE 

Meaning 

System problem, or limit for MULTLEV is too high. 
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6. TAILOR 


The TAILOR processor forms one part of the procedure for the installation of a 
new GCOS 7 Release. The purpose of the TAILOR processor is to build the Set of 
disks necessary for an operational system by using, as appropriate: 


e Astandard Production Set (P-Set) as input, or 
e Astandard Reference Set (R-Set) as input. 


In addition to the TAILOR processor, the GIUF function COPY_SITEFILES is 
available for copying the site-specific files that are to be kept with the new GCOS 
7 Release. 
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6.1 System Files 


An operational system includes a set of system files located on one or several FSA 
disks. 


6.1.1 General Rules 


Some system files must be present at each installation, and are said to be 
mandatory. Other system files may be absent because they relate to an optional 
feature which is not considered useful and/or because the feature has not been 
purchased. All such files are said to be optional. Moreover, various residency 
rules are enforced by GCOS 7, which affects the possible locations for the files on 
the disks. 


TAILOR does not treat certain files, since they have their own processors: 


e SITE.MFT (file used for management of VOLSETs). See the MFT User and 
Administrator's Guide. 


e SITE.QUOTA (file used for management of disk occupation). See 
Administering the Storage Manager. 


6.1.2 System File Domains 


System files can be sorted into five Domains: 


e The GCOS files Domain 

e The DSA files Domain 

e The OLTD files Domain 

e The FIRMWARE files Domain 
e The GSF files Domain. 


The GCOS, OLTD, GSF, and FIRMWARE Domains must be present on all 
working sites. The DSA Domain is not obligatory. If telecommunications via a 
front-end processor are required, the DSA file Domain may be delivered and 
installed asynchronously. 


The TAILOR commands detailed in this chapter are grouped according to the file 
Domain to which each belongs. 
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In a P2P configuration, a second production Set is built from the P-Set. The 
created Set is called the P2-Set. Advantages of the P2P-Configuration include: 


e The P-Set and P2-Set work in alternate mode. At any given moment, either one 
of them may be the running system Set. 


e Either Set may be mono- or multi-volume, independently of the other. 
e The non-running Set may be updated without affecting the other Set. 


The Reference-Set (R-Set) is a Set of disks created by the IUF job INSTAL_RSET 
at Installation time. This Set consists predominantly of loaded system files. 
Although it is possible to use the R-Set as the running Set, this is not what it is 
intended for. It is primarily intended to be used as the TAILOR input Set for 
building Sets of running disks. These Sets of running disks are in turn named 
"Production-Sets" (P-Sets). 
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6.3 TAILOR Constraints 


Volumes defined as RSDVOL and RSDVOLI must be FSA. 


SYSVOL, RSDVOL, and RSDVOL1 are not allowed on mirrored disks. 


The following TAILOR commands prevent the allocation of unacceptable system 


files on mirrored disks: 


BKST1, ISL, LIB, PVMF, TVMF, MIRLOG, HALOCK 


The following files may be allocated on FSA disks other than SYSVOL: 


SYS.DSABLIB 

SYS.DSALMLIB 

SYS.DSASLIB 

SYS.DSACMD 

SYS.DSACONF 

SYS.DSACORE 

SYS.DSADUMP 

SYS.DSATRC* (for FCP7 only) 
SYS.FW.BINLIB 

SYS.FW.CCULIB (not available for XTA) 
SYS.FW.GENLIB 

SYS.FW.LMLIB 

SYS.FW.NFTLIB (not available for XTA) 
SYS.FW.SLLIB 

SYS.FW.PATCH (not available for XTA) 
SYS.FW.PRT 

SYS.GSF.BINLIB 

SYS.GSF.LMLIB 

SYS.GSF.SLLIB 

SYS.GSF.SMLIB 

SYS.GSF.UFAS 

SITE.HALOCK (if applicable) 
SITE.MIRLOG (if applicable) 
SITE.CMS_CDD_namei (if applicable) 
SITE.CMS_CSD (if applicable) 
SITE.CMS _DS_namel_name2 (if applicable) 
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6.3.1 Introduction to TAILOR 


TAILOR uses a processor with a command language which allows the five system 
file Domains (GCOS, DSA, OLTD, FW, and GSF) to be treated independently of 
each other. 


For each system file Domain, a set of commands is available for the definition of 
the characteristics for those files, which have selectable features, and for the disks 
to support them. 


TAILOR builds the Set of disks in two steps: 


1. Command analysis 
2. File creation. 


The second step does not start until the first is finished, which means that requests 
are stored and not immediately executed. 


There are three ways of giving commands, each corresponding to a specific 
environment. Commands may be submitted from: 


e A file 
e The MAIN console 
e AnIOF console. 


6.3.2 TAILOR and GCL 
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TAILOR uses the GCL interpreter to manage its commands, which makes available 
HELP, prompting facilities, and menus, according to the calling environment. 
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Structure of the TAILOR Command Language 


SESSION AND DEFINITION COMMANDS 
TAILOR commands may be sorted into two categories: 


e "Session" commands, which determine the actions to be taken during a TAILOR 
session. 


e "Definition" commands, which are used to define the characteristics of the disks 
and files which make up the "Production-Set". 


As we saw earlier, each system file Domain is associated with a command set. A 
given Domain-related "definition" command set is accessed via the TLRGEN 
session command. 


Each definition command set includes two types of command: 


e Commands that define characteristics for the disks that are to contain the files of 
the Domain concerned. 


e¢ Commands which define characteristics for the files belonging to the specified 
Domain. 


Note that there are not as many file definition commands as files in any given 
Domain, because some mandatory files have no selectable features. 


A sequence of TAILOR commands related to any one of the Domains - GCOS, 
DSA, OLTD, GSF, or FW - is described as a "TLRGEN Session". 


DEFAULT VALUES 


To create a file, TAILOR needs a set of values, or allocation parameters. The file 
definition command parameters supply these. 


All have default values. If no definition command is given for a mandatory file, its 
default values will be used. For optional files, the same rule applies: the activation 
of a file definition command is needed only if any of its default parameters does 
not match user requirements. 


A TLRGEN session results in a set of values obtained by merging default and user 
values. This set of values is stored in a permanent file and may be used for the 
default values for the next TLRGEN session on the same Domain. 


This set of values may be updated at each TLRGEN session and constitutes, for a 
given Domain, a dynamic user-specific set of defaults, called "last COMSET". 
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In the following pages, "initial COMSET" specifies a standard delivered set of 
default values, and "last COMSET" (or "latest" COMSET) stands for the 
user-specific set. See the paragraph Default TLRGEN Sessions below for more 
information on default values. 


1(2)3 IMPORTANT: 

1. IfCOMSET = LAST when the SYSVOL concerned does not belong to the 
same DEVCLASS as that declared for the last (i.e., previous latest) 
TLRGEN session, certain default file definition parameters (especially 
SIZE) must be modified, as they would otherwise be insufficient. 


2. User subfiles should never be placed in system files/libraries, as they 
would be lost when updating or returning to a previous Technical Status. 
The only exceptions to this rule are the SITE.HELP file and the 
SYS.DSACOMF file. 


It is recommended, in these two cases only, that suitable user objects be stored 
in the files concerned where they will be preserved in the event of a system 
update or a return to an earlier Technical Status. 
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6.4 Session Commands 


This command level is designated by the specific prefix "T". The seven session 
commands are: 


e TLRGEN 

e TLREXEC 

e TLRPRINT 

e TLRRESET 

e TLRCANCEL 

e TLRSTAT 

¢ QUIT 

The session command level may be left by entering either: 
e QUIT; 


e /(alone ona line). 
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The TLRGEN command 


Function 


To start a TLRGEN session. 


Format 


TLRGEN FILESET={GCOS|DSA|OLTD| FW|GSF} 


[COMSET={LAST|INITIAL}] ; 


Parameters 

FILESET is mandatory and names the file Domain for which the 
accompanying definition commands are to be used. 

COMSET is used to specify the set of default values to be applied 
to the definition commands. 

When COMSET = 

LAST the values resulting from the last TLRGEN session for 
the specified Domain, are taken as the defaults; this is 
the default value for COMSET. 

INITIAL the set of standard initial default values is used. 

Rules 


COMSET = LAST may be used only if a "latest" COMSET exists for the specified 
Domain. 


For a given Domain, this command cannot be issued after a TLREXEC command. 
EXAMPLES: 

TLRGEN FILESET=GCOS COMSET=INITIAL; 

TLRGEN DSA LAST; 


TLRGEN FW; 


TLRGEN GSF; 


Q 
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The TLREXEC Command 


Function 


To specify the file Domain for which files are to be created. 


Format 


TLREXEC FILESET={GCOS|DSA|OLTD| FW|GSF} 


[FROM={BEG|alphanum8}] ; 


Parameters 


FILESET is mandatory and defines the Domain for which files 
are to be created. 


FROM is used after an ABORT during file creation in the 
Domain concerned, in order to define a restart label 
name (as displayed in the creation phase report for the 
time at which the ABORT occurred). By default, 
FROM = BEG 1s assumed; this is appropriate for the 
normal case where no files have yet been created for 
the Domain. 


Rules 


e The TLREXEC command may be given only if a complete "latest" COMSET 
exists for the specified Domain. 


e Only the latest TLREXEC command activation may be used for a given 
Domain. 


EXAMPLES: 


TLREXEC FILESET=GCOS FROM=BEG; 
TLREXEC DSA; 
TLREXEC GSF; 


TLREXEC FILESET=FW FROM=F5; 


TLREXEC DSA D3; 


Q 
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The TLRPRINT Command 


Function 


To display a summary of the last COMSET for a given file Domain. 


Format 


TLRPRINT FILESET={GCOS|DSA|OLTD|FW|GSF} ; 


Parameters 

FILESET is mandatory and names the file Domain whose last 
COMSET is to be summarized. 

Rules 


The TLRPRINT command may be given only ifa "latest" COMSET exists for the 
file Domain concerned. 


EXAMPLES: 


TLRPRINT FILESET=GCOS; 


TLRPRINT DSA; 


TLRPRINT GSF; 
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The TLRRESET Command 


Function 


To clear the "latest" COMSETs, either completely or partially, for all the file 
Domains. 


Format 


TLRRESET [RESET={STRONG|WEAK}] ; 


Parameters 

STRONG means that all the "latest" COMSETs are reset. This is 
the default option. 

WEAK means that only those values relevant to disk 
characteristics are reset. 

Rules 


e A TLRRESET command cannot follow TLREXEC commands. 


e After TLRRESET RESET = STRONG, the only available default values for 
TLRGEN sessions are those of the initial COMSET. 


e After TLRRESET RESET = WEAK, "latest" COMSETs may be used for 
TLRGEN sessions, but cannot be used for TLREXEC or TLRSTAT. 


EXAMPLES: 


TLRRESET RESET=STRONG; 


TLRRESET WEAK; 


TLRRESET ; 


Q 
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The TLRCANCEL Command 


Function 


To cancel the TLREXEC command for a given file Domain. 


Format 


TLRCANCEL FILESET={GCOS|DSA|OLTD|FW|GSF} ; 


Parameters 

FILESET represents the name of the file Domain whose creation 
request is to be cancelled. 

Rules 


The TLRCANCEL command has no effect if no TLREXEC command has been 
activated for the Domain concerned. 


NOTE: 
The TLRCANCEL command is the only way of modifying definition command 
parameter values for a given Domain after a TLREXEC command has been 
issued. 


EXAMPLES: 


TLRCANCEL FILESET=GCOS; 


TLRCANCEL DSA; 


TLRCANCEL GSF; 


Q 
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The TLRSTAT Command 


Function 


To display a summary of TAILOR processing. 


Format 


TLRSTAT; 
NoTES: 
In the resulting printout: 


1. "Executable" means that a complete last COMSET exists 


2. "To be built" means that a TLREXEC command has been activated for the 
specified Domain. 
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6.5 Definition Commands 


47 A2 23US 


The default values applied to definition commands may differ, depending on the 
value supplied for the COMSET parameter in the TLIRGEN command. 


For this reason, no default values are specified in the definition command 
descriptions. The standard initial default values are given in Table 6-1 GCOS File 
Domain Default Values. 


Disk Definition Commands 


These commands relate to the five Domains, GCOS, DSA, OLTD, GSF and FW, 
and are used to define disk characteristics. The disk definition commands are: 


SYSVOL 

RSDVOL 

RSDVOLI 

NRDVOL 

NRDVOLI1 

CATVOL (for the GCOS Domain only). 


All of these commands have the same syntax, requiring specification of the media 
name and device class for a disk. 
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The SYSVOL Command 


Function 


To define system disk characteristics. 


Format 


SYSVOL MD=alphanum6 DVC=MS/FSA; 


Parameters 

MD is mandatory and introduces the MEDIA name of the 
disk. 

DVC is mandatory and specifies the DEVICE CLASS of the 
disk that must be FSA for the system disk. 

Rules 


e The system disk must be FSA. 


e The system disk is the same for the five file Domains, and may be defined in any 
Domain. 


e Once defined, system disk characteristics cannot be changed until a TLRRESET 
command is issued. 


e Any reference to the system disk in file definition commands must use the 
strings "SYS" or "SYSVOL". 


EXAMPLE: 


SYSVOL MD=P27901 DVC=MS/FSA; 


Q 
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The RSDVOL Command 


Function 


To define the characteristics of a resident disk other than the system disk, for a 
given file Domain. 


Format 


RSDVOL MD=alphanum6 DVC=MS/FSA; 


Parameters 

MD is mandatory and introduces the MEDIA name of the 
disk. 

DVC is mandatory and specifies the DEVICE CLASS of the 
disk. 

Rules 


e Aresident disk must be FSA. 


e Aresident disk defined using the RSDVOL command is private to the Domain 
that defines it. 


e Any reference to this disk in file definition commands must be made with the 
strings "RSD" or "RSDVOL" (in the Domain for which RSDVOL command has 
been activated). 


EXAMPLE: 


RSDVOL MD=P27902 DVC=MS/FSA; 


Q 
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The RSDVOL1 Command 


Function 


To define the characteristics of a second resident disk other than the system disk, 
for a given file Domain. 


Format 


RSDVOL1 MD=alphanum6 DVC=MS/FSA; 


Parameters 


MD 


DVC 


Rules 


is mandatory and introduces the MEDIA name of the 
disk. 


is mandatory and specifies the DEVICE CLASS of the 
disk. 


e A resident disk must be FSA. 


e Aresident disk defined using the RSDVOL1 command is private to the file 
Domain that defines it. 


e Any reference to this disk in file definition commands must use the strings 
"RSD1" or "RSDVOL1" (in the Domain for which RSDVOL1 command has 
been activated). 


EXAMPLES: 


RSDVOL1 


RSDVOL1 


Q 
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MD=FSA3 


FSA3 MS/ 


DVC=MS/FSA; 


ESA; 


47 A2 23US 


TAILOR 


The NRDVOL Command 


Function 


To define, for a given file Domain, the characteristics of a non-resident disk. 


Format 


NRDVOL MD=alphanum6 DVC=MS/FSA; 


Parameters 

MD is mandatory and introduces the MEDIA name of the 
disk. 

DVC is mandatory and specifies the DEVICE CLASS of the 
disk. 

Rules 


e Anon-resident disk defined using the NRDVOL command must be FSA. 


e Anon-resident disk defined using the NRDVOL command is private to the 
Domain that defines it. 


e Any reference to this disk in file definition commands must use the strings 
"NRD" or "NRDVOL" (in the Domain for which NRDVOL command has been 
activated). 


EXAMPLES: 


NRDVOL MD=FSA4 DVC=MS/FSA; 


NRDVOL FSA4 MS/FSA; 
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The NRDVOL1 Command 


Function 


To define the characteristics of a second non-resident disk for a given file Domain. 


Format 


NRDVOL1 MD=alphanum6 DVC=MS/FSA; 


Parameters 


MD 


DVC 


Rules 


is mandatory and introduces the MEDIA name of the 
disk. 


is mandatory and specifies the DEVICE CLASS of the 
disk. 


e Anon-resident disk defined using the NRDVOL1 command must be FSA. 


e Anon-resident disk defined using the NRDVOL1 command is private to the 
Domain that defines it. 


e Any reference to this disk in file definition commands must use the strings 
"NRD1", or "NRDVOLI1" (in the Domain for which the NRDVOL1 command 
has been activated). 


EXAMPLE: 


NRDVOL1 MD=FSA5 


Q 
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DVC=MS/FSA; 
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The CATVOL Command 


Function 


To define the characteristics of the disk containing a valid SITE.CATALOG file for 
use in cataloging the site files created. 


Format 


CATVOL MD=alphanum6 DVC=MS/FSA; 


Parameters 

MD is mandatory and introduces the MEDIA name of the 
disk. 

DVC is mandatory and specifies the DEVICE CLASS of the 
disk. 

Rules 


e When SITE.STARTUP, SITE.HELP, SITE.IN, SITE.HALOCK or 
SITE.MIRLOG file creation is required while SITE.CATALOG file creation is 
not, both the CATVOL command and CATFL PRES = 0 must be specified 
explicitly. 


e When SITE.CATALOG file creation is required (CATFL PRES = 1), the 
CATVOL command is ineffective. 


EXAMPLES: 


CATVOL MD=P27901 DVC=MS/FSA; 


CATVOL P27901 MS/FSA; 


Q 
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Remarks on Disk Definition Commands 


DEFAULT VALUES 


When starting a TLRGEN session, you can choose the set of default values to be 
applied as parameters of file definition commands. 


When COMSET = INITIAL, no default values are assumed for disk characteristics, 
except for those of the system disk if this was defined in an earlier TLRGEN 
session. 


When COMSET = LAST, the same rule applies as for file definition command 
parameters (see earlier in this chapter), in that the last-entered values are taken as 
the default values. 


IMPORTANT: 
Remember that if COMSET = LAST when the SYSVOL concerned does not 
belong to the same DEVCLASS as that declared for the last (i.e. previous latest) 
TLRGEN session, certain default file definition parameters (especially SIZE) 
must be modified, as they would otherwise be insufficient. 


i) 


ABOUT THE DISKS 


Each of these disks is private to a given file Domain, with the exception of the 
system disk. Therefore, if a disk has to support files belonging to different 
Domains, it must be defined separately for each of those Domains. 


The system disk must be FSA. 


6-22 47 A2 23US 


TAILOR 


6.6 The GCOS Domain 


This Domain has the specific prefix "G" and contains the definition commands 
relevant to GCOS 7 system files. These commands may be used by activating the 
TLRGEN command with FILESET = GCOS. 


In addition to the six disk definition commands already dealt with, the GCOS 
Domain contains a file-definition command for each of the files that have 
selectable features. These commands are: 


BKST 
BKST1 
CATFL 
CLC 

CMS 
EOGEN 
ERLOG 
HALOCK 
ISL 
JAFTER 
JAS 
JBEFORE 
KNODET 
LIB 
LOGC 
MIRLOG 
PVMEF 
QM 
QMBACK 
SITHELP 
SITIN 
SPOOL 
SPDUMP 
STUP 
SWLOG 
SYIN 
SYO 
SYSDUMP 
TVMF 
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6.6.1 Principal Parameters 


File definition commands relevant to the GCOS Domain all have the same 
structure, featuring three main parameters as follows: 


PRES 


TO 


SIZE 


is used to require or prevent the creation of an optional 
file. It does not usually exist for mandatory files. 


is used to specify the location of a file. The values it 
may take are the symbolic disk names as described in 
the disk definition commands in the paragraph 
Definition Commands above. This parameter is not 
used for files that must be created on the system disk. 


Any disk referenced by this parameter must have 
previously been defined using the appropriate 
disk-definition command. 


is a decimal value used to specify the size of a file. 
Not applicable to files with a fixed size. 


The other parameters used are described with each command. 
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6.6.2 File Definition Commands 


The BKST Command 


Function 


To specify the size of the SYS.BKST file. 


Format 


BKST SIZE=digit5; 


Parameters 

SIZE As described in the paragraph Principal Parameters. 
Default values are given in Table 6-1 GCOS File 
Domain Default Values. 
See also Calculating Backing-Store File Sizes in the 
appendix System Files. 

EXAMPLES: 


BKST SIZE=12750; 


BKST 13600; 


Q 
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The BKST1 Command 


Function 


Specifies the location and size of the SYS.BKST1 file and checks that it is not 
allocated on a mirrored disk. 


Format 


BKST1 


[PRES={0|1}] [TO={SYS|RSD|RSD1|NRD|NRD1}] 


[SIZE=digit5]; 


Parameters 

PRES, TO As described in the paragraph Principal Parameters. 
See the standard default value in Table 6-1 GCOS File 
Domain Default Values. 

SIZE As described in the paragraph Principal Parameters. 
See the standard default value in Table 6-1 GCOS File 
Domain Default Values. 
See also Calculating Backing-Store File Sizes in the 
appendix System Files. 
The maximum size cannot exceed 65535 blocks. 

EXAMPLES: 

BKST1 PRES=1 TO=RSD SIZE=10000; 

BKST1 SYS; 

BKST1 SIZE=20000; 

O) 
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The CATFL Command 


Function 


To require or prevent creation of the SITE.CATALOG file as well as specifying its 
location and number of objects. 


Format 
FSA: 


CATFL [PRES={0|1}] [TO={SYS|RSD|RSD1}] [NBOBJ=digit6] ; 


Parameters 
PRES, TO As described in the paragraph Principal Parameters. 
NBOBJ Represents the maximum number of objects (100000 


on an FSA disk) in the SITE.CATALOG file. See the 
standard default values in Table 6-1 GCOS File 
Domain Default Values. 
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Rules 


e The SITE.CATALOG file can be on either the system disk or any other resident 
disk. 


e See the tables File Size and Number of Objects at the end of this chapter for the 
correspondence between objects and blocks. 


EXAMPLES: 


CATFL PRES=1 TO=SYS NBOBJ=600; 


CATFL 1 RSD; 


CATFL NBOBJ=600; 


CATFL PRES=0; 


Q 
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The CLC Command 


Function 


To require or prevent creation of the SYS.CLC file and to specify its location. 


Format 
FSA: 


CLC [PRES={0|1}] [TO={SYS|RSD|RSD1|NRD|NRD1}] ; 


Parameters 

PRES, TO As described in the paragraph Principal Parameters; 
see their standard default values in Table 6-1 GCOS 
File Domain Default Values. 

Rules 


The SYS.CLC file may reside on any disk. 


EXAMPLES: 


CLC PRES=1 TO=RSD1; 


CLC 1 RSD; 


CLC 1; 
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The CMS Command 


Function 
To require or prevent creation of the following files and to specify their location: 


SITE.CMS CSD 
SITE.CMS_CDD_namel 
SITE.CMS_CDD_name2 
SITE.CMS_DS_namel_name2 


namel and name? are the network names of the two coupled systems. 


Format 

CMS [PRES={0|1}] [TO={SYS|RSD|RSD1|NRD|NRD1}] 
NAME1=char4 NAME2=char4; 

Parameters 

PRES, TO As described in the paragraph Principal Parameters. 
See their standard default values in Table 6-1 GCOS 
File Domain Default Values. 

NAMEI The network name of one coupled system. 

NAME2 The network name of the other coupled system. 

Rules 


The SITE.CMS * files may be allocated on any FBO shared disk. 


EXAMPLES: 


CMS PRES=1 TO=NRD NAME1=M001 NAME2=M002; 
CMS 1 NRD1 M001 M002; 


Q 
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The ERLOG Command 


Function 


To require or prevent creation of the SYS.ERLOG file as well as to specify its 
location. 


Format 


ERLOG [PRES={0|1}] [TO={SYS|RSD|RSD1}]; 


Parameters 

PRES, TO As described in the paragraph Principal Parameters. 
See their standard default values in Table 6-1 GCOS 
File Domain Default Values. 

Rules 


The SYS.ERLOG file may be on any disk. 


NOTE: 
The SYS.ERLOG file is mandatory so you must create it if TAILOR has not 
done this. 


EXAMPLES: 


ERLOG PRES=1 TO=RSD; 


ERLOG 1; 


Q 
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The HALOCK Command 


Function 


To require or prevent creation of the SITE.HALOCK file and to specify its 
location. 


Format 


HALOCK  [PRES={0|1}] [TO={SYS|RSD|RSD1|NRD|NRD1}] 


Parameters 

PRES, TO As described in the paragraph Principal Parameters. 
See their standard default values in Table 6-1 GCOS 
File Domain Default Values. 

Rules 


The SITE.HALOCK file may be allocated on any FBO disk. 
It may not be allocated on mirrored disks. 


EXAMPLES: 


HALOCK PRES=1 TO=RSD; 
HALOCK 1; 


Q 
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The ISL command 


Function 


Specifies the location of the SYS.SYSTEM file and checks that it is not allocated 
on a mirrored disk. 


Format 


ISL TO={SYS|RSD|RSD1|NRD|NRD1}; 


Parameters 

TO As described in the paragraph Principal Parameters. 
See the standard default values in Table 6-1 GCOS File 
Domain Default Values. 

EXAMPLES: 

ISL TO=RSD; 

ISL NRD; 

O 
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The JAFTER Command 


Function 


To require or prevent creation of the SYS.JADIR file and of primary and secondary 
journal files and to specify their location and sizes. 


Format 


JAFTER 


[ 

[JOURNAL _SIZE=digit4] 
[PRIMARY _MEDTA=name6 ] 
[SECONDARY_MEDTA=name6 ] 
[AUTOCYCLE=boo] ] 


Parameters 
PRES, TO 

SIZE 

JOURNAL SIZE 


BLOCK SIZE 


PRIMARY MEDIA 
PRIMARY DVC 
SECONDARY MEDIA 
SECONDARY DVC 
AUTOCYCLE 


SECDCOPY 


PRES={0|1}] 


[TO={SYS|RSD|RSD1}] [SIZE=digit8] 
[BLOCK_SIZE=digit5] 
[PRIMARY_DVC=char11] 
[SECONDARY _DVC=char11] 
[SECDCOPY=boo1] ; 


As described in the paragraph Principal Parameters. 
Defines the size of the SYS.JADIR file. 


Defines the size of the Primary Journal files in 
cylinders. 


Defines the block size of the Primary Journal files in 
bytes. 


Defines the media name of the Primary Journal files. 
Defines the device class of the Primary Journal files. 
Defines the media name of the Secondary Journal files. 
Defines the device class of the Secondary Journal files. 


Sets the automatic cycling mode for JAS generation. 
(JAS = Journalization Advanced Service). 


Sets the dual copy mode for JAS generation. 


Standard default values for the above parameters are given in Table 6-1 GCOS File 


Domain Default Values. 


For more information, refer to the File Recovery Facilities User's Guide. 
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Rules 


1. TheSYS.JADIR file may be allocated on any disk. 


2. The allocation of After Journal primary and secondary files by TAILOR is 
standard. That is to say, with the JAFTER command primary files can be 
allocated only on disk, secondary files can be allocated only on tape or 
cartridge. 


3. IfPRES = 1, the P_MD and P_DVC parameters must be given values. 


In order to define a list of media names for primary and secondary After 
Journal files, the MAINTAIN JAS utility may be used. For information on 
MAINTAIN_JAS, refer to the File Recovery Facilities User's Guide. 


EXAMPLES: 


JAFTER 0; 


JAFTER PRES=1 TO=SYS SIZE=250 JOURNAL_SIZE=80 
BLOCK_STZE=8192 PRIMARY _MEDIA=MED1 
PRIMARY_DVC=MS/FSA SECONDARY_MEDIA=MED2 
SECONDARY_DVC=MT. SECDCOPY=1 AUTOCYCLE=1; 


JAFTER PRES=1 TO=RSD PRIMARY_MEDIA=MED1 
RIMARY_DVC=MS/FSA AUTOCYCLE=0; 


ine] 
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The JAS Command 


Function 


To require or prevent creation of the SYS.JASBLUE and SYS.JASGREEN files 
and to specify their location. 


Format 


JAS [PRES={0|1}] [TO={SYS|RSD|RSD1|NRD|NRD1}] 


Parameters 

PRES, TO As described in the paragraph Principal Parameters. 
See their standard default values in Table 6-1 GCOS 
File Domain Default Values. 

Rules 


The SYS.JASBLUE and SYS.JASGREEN files may be allocated on any disk. 


EXAMPLES: 


JAS 1; 
JAS PRES=1 TO=RSD; 


Q 
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The JBEFORE Command 


Function 


To require or prevent creation of the SYS.JRNAL file and to specify its location, 
size and file block size. 


Format 
FSA: 


JBEFORE [PRES={0|1}] [TO={SYS|RSD|RSD1|NRD|NRD1}] 
[SIZE=digit8] [{FILEBLOCK_SIZE|BLKSZ}={512|4096}]; 


Parameters 

PRES, TO, SIZE As described in the paragraph Principal Parameters. 
See their standard default values in Table 6-1 GCOS 
File Domain Default Values. 

FILEBLOCK_ SIZE Defines the block size for the file in bytes. 

Rules 


The SYS.JRNAL file may be on any disk. 


EXAMPLES: 


JBEFORE PRES=1 TO=RSD1 SIZE=680 FILEBLOCK_SIZE=4096; 
JBEFORE 1 RSD; 


JBEFORE 1 SIZE=3; 


JBEFORE NRD 16368 512; 


Q 
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The KNODET Command 


Function 


To specify the location and size of the SYS.KNODET file. 


Format 
FSA: 


KNODET [TO={SYS|RSD|RSD1}] [SIZE=digit8]; 


Parameters 

TO, SIZE As described in the paragraph Principal Parameters. 
See the standard default values in Table 6-1 GCOS File 
Domain Default Values. 

Rules 


The SYS.KNODET file may be on any resident disk. 


EXAMPLES: 


KNODET TO=SYS SIZE=3000; 


KNODET SIZE=2000; 


KNODET RSD; 
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The LIB Command 


Function 


Specifies the location and size of the SYS.LIB file and checks that it is not 
allocated on a mirrored disk. 


Format 
FSA: 


LIB [TO={SYS|RSD|RSD1|NRD|NRD1}] [SIZE=digit8]; 


Parameters 


TO As described in the paragraph Principal Parameters. 
See the standard default value in Table 6-1 GCOS File 
Domain Default Values. 


SIZE As described in the paragraph Principal Parameters. 


See the standard default value in Table 6-1 GCOS File 
Domain Default Values. 


See also Calculating Backing-Store File Sizes, in the 
appendix System Files. 


The maximum size cannot exceed 65535 blocks. 


EXAMPLES: 


LIB TO=RSD SIZE=10000; 


LIB SIZE=6800; 


LIB NRD; 


Q) 
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The LOGC Command 


Function 


To require or prevent creation of the SYS.LOGC file and to specify its location. 


Format 


LOGC [PRES={0|1}] [TO={SYS|RSD|RSD1}]; 


Parameters 

PRES, TO As described in the paragraph Principal Parameters. 
See the standard default values in Table 6-1 GCOS File 
Domain Default Values. 

Rules 


The SYS.LOGC file may be on any disk. 


EXAMPLES: 


LOGC PRES=1 TO=RSD; 


Q) 
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The MIRLOG Command (if applicable) 


Function 


Specifies the location of the SITE.MIRLOG file and checks that it is not allocated 
on a MIRROR volume. 


Format 


MIRLOG  [PRES=0|1] [TO={SYS|RSD|RSD1|NRD|NRD1}]; 


Parameters 

PRES, TO As described in the paragraph Principal Parameters. 
See the standard default value in Table 6-1 GCOS File 
Domain Default Values. 

Rules 


The SITE.MIRLOG file may be allocated on any FBO volume. 
It may not be allocated on a MIRROR volume. 


EXAMPLES: 


MIRLOG PRES=1 TO=RSD1; 
MIRLOG 1; 


Q 
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The PVMF Command 


Function 


Specifies the location and size of the SYS.PVMF file and checks that it is not 
allocated on a mirrored disk. 


Format 
FSA: 


PVMF [TO={SYS|RSD|RSD1|NRD|NRD1}] [SIZE=digit8]; 


Parameters 
TO As described in the paragraph Principal Parameters. 


See the standard default value in Table 6-1 GCOS File 
Domain Default Values. 


SIZE As described in the paragraph Principal Parameters. 


See the standard default value in Table 6-1 GCOS File 
Domain Default Values. 


See also Calculating Backing-Store File Sizes, in the 
appendix System Files. 


The maximum size cannot exceed 65535 blocks. 


EXAMPLES: 


PVMF TO=SYS SIZE=10000; 
PVMF SIZE=3400; 
PVMF NRD1; 


Q 
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The QM Command 


Function 


To specify the location of the SYS.QM file. 


Format 


QM [TO={SYS|RSD|RSD1|NRD|NRD1}] [SIZE=digit5]; 


Parameters 

TO As described in the paragraph Principal Parameters. 
See the standard default value in Table 6-1 GCOS File 
Domain Default Values. 

EXAMPLES: 


QM TO=RSD, SIZE=400; 


QM SYS; 


Q 
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The QMBACK Command 


Function 


To specify the location of the SYS.QM BACKUP file. 


Format 


QMBACK [TO={SYS|RSD|RSD1|NRD|NRD1}] [SIZE=digit 5]; 


Parameters 

TO As described in the paragraph Principal Parameters. 
See the standard default value in Table 6-1 GCOS File 
Domain Default Values. 

EXAMPLES: 


QMBACK TO=RSD, SIZE=400; 
QMBACK SYS; 


Q 
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The SITHELP Command 


Function 


To specify the location and size of the SITE.HELP file. 


Format 
FSA: 


SITHELP [PRES={0|1}] [TO={SYS|RSD|RSD1}] [SIZE=digit8]; 


Parameters 

PRES, TO, SIZE As described in the paragraph Principal Parameters. 
See the standard default values in Table 6-1 GCOS File 
Domain Default Values. 

Rules 


The SITE.HELP file may be located on any disk. 
If PRES = 1 and CATFL PRES = 0, the CATVOL command must be used to define 
where the SITE.HELP file is to be cataloged. 


EXAMPLES: 


SITHELP TO=SYS SIZE=300; 


SITHELP SIZE=510; 


SITHELP RSD1; 


Q 
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The SITIN Command 


Function 


To require or prevent creation of the SITE.IN file and to specify its location 
and size. 


Format 


FSA: 


SITIN [PRES={0|1}] [TO={SYS|RSD|RSD1}] [SIZE=digit8] ; 


Parameters 

PRES, TO, SIZE As described in the paragraph Principal Parameters. 
See the standard default values in Table 6-1 GCOS File 
Domain Default Values. 

Rules 


The SITE.IN file may be on any disk. If PRES = 1 and CATFL PRES = 0, the 
CATVOL command must be used to define where SITE.IN is be cataloged. 


EXAMPLES: 


SITIN PRES=1 TO=RSD SIZE=500; 


SITIN 1 SYS; 


SITIN SIZE=850; 


Q 
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The SPDUMP Command 


Function 


To specify the location of the SYS.SPDUMP file. 


Format 


SPDUMP [TO={SYS|RSD|RSD1|NRD|NRD1}]; 


Parameters 

TO As described in the paragraph Principal Parameters. 
See the standard default values in Table 6-1 GCOS File 
Domain Default Values. 

Rules 


The SYS.SPDUMP file may be allocated on any disk. 


EXAMPLES: 


SPDUMP TO=RSD; 
SPDUMP NRD1; 


Q 
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The SPOOL Command 


Function 


To specify the location and size of the SYS.SPOOLO file. 


Format 
FSA: 


SPOOL [TO={SYS|RSD|RSD1}] [SIZE=digit8]; 


Parameters 

TO, SIZE As described in the paragraph Principal Parameters. 
See the standard default values in Table 6-1 GCOS File 
Domain Default Values. 

Rules 


The SYS.SPOOLO file may be on any resident disk. 


EXAMPLES: 


SPOOL TO=RSD SIZE=2000; 
SPOOL RSD SIZE=1275; 


Q 
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The STUP Command 


Function 


To require or prevent creation of the SITE.STARTUP file and to specify its location 
and size. 


Format 
FSA: 


STUP [PRES={0|1}] [TO={SYS|RSD|RSD1}] [SIZE=digit8]; 


Parameters 

PRES, TO, SIZE As described in the paragraph Principal Parameters. 
See the standard default values in Table 6-1 GCOS File 
Domain Default Values. 

Rules 


The SITE.STARTUP file must be on a resident disk. If PRES = 1 and CATFL 
PRES = 0, the CATVOL command must be used to define where SITE.STARTUP 
is to be cataloged. 


EXAMPLES: 


STUP PRES=1 TO=SYS SIZE=200; 
STUP 1 RSD; 
STUP PRES=1 SIZE=680; 


Q 
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The SWLOG Command 


Function 


To specify the location of the SYS.SWLOG file. 


Format 


SWLOG [TO={SYS|RSD|RSD1|NRD|NRD1}] ; 


Parameters 

TO As described in the paragraph Principal Parameters. 
See the standard default values in Table 6-1 GCOS File 
Domain Default Values. 

EXAMPLES: 


SWLOG TO=RSD1; 


SWLOG NRD; 


Q 
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The SYIN Command 


Function 


To specify certain allocation parameters for the SYS.IN file. 


Format 


SYIN [SIZE=digit8] [INCRSIZE=digit5] [MAXSTZE=digit8]; 


Parameters 

SIZE described in the paragraph Principal Parameters. 

INCRSIZE defines the increment size, in blocks, of the SYS.IN 
file. 

MAXSIZE defines the maximum size, in blocks, of the SYS.IN 
file. 


See the standard default values in Table 6-1 GCOS File Domain Default Values. 


EXAMPLES: 


SYIN SIZE=1000 INCRSIZE=100 MAXSTZE=2000; 


SYIN 680,170,1700; 


SYIN MAXSIZE=5000; 


Q 
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The SYO Command 


Function 


To require or prevent creation of the SYS.OUT file and to specify its location, size 
and some other allocation parameters. 


Format 


FSA: 


SYO [PRES={0|1}] [TO={SYS|RSD|RSD1}] [SIZE=digit8] 
[SPLIT=(name:size [,name:size])] [INCRSIZE=digit5] 


[MAXSIZE=digit8] 


[BLKSZ=digit5] [RECSIZE=digit5] 


[LTKSZ=digit5]; 


Parameters 


PRES, TO, SIZE 


SPLIT 


INCRSIZE 


MAXSIZE 


BLKSZ 
RECSIZE 
LTKSZ 


As described in the paragraph Principal Parameters. 


See the standard default values in Table 6-1 GCOS File 
Domain Default Values. 


may be used to define a maximum of two extra 
locations for the SYS.OUT file, provided that all the 
disks concerned have the same device class, and 
where: 


name = {SYS|RSD|RSD1} 


size = the size of the extent to be allocated to 
SYS.OUT on the volume concerned. 


defines the increment size in cylinders or blocks as 
appropriate. 


defines the maximum file size in cylinders or blocks as 
appropriate. 


defines the block size for the file in bytes. 
defines the record size for the file in bytes. 


defines the logical track size for the file as a number of 
blocks. 


See the standard default values in Table 6-1 GCOS File Domain Default Values. 
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Rules 


The SYS.OUT file must be on a resident disk. 


NOTE: 
SYS.OUT is a mandatory file. You must create it if TAILOR does not do it. 


EXAMPLES: 


SYO PRES=1 TO=RSD SIZE=30000 INCRSIZE=2 MAXSIZE=50000; 


SYO 1; 


SYO PRES=1 MAXSIZE=60000; 


SYO PRES=1 TO=SYS SPLIT=(RSD:30000, RSD1:30000) ; 


SYO PRES=1; 


Q 
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The SYSDUMP Command 


Function 


To specify the location and size of the SYS.SYSDUMP file. 


Format 
FSA: 


SYSDUMP [TO={SYS|RSD|RSD1}] [SIZE=digit8]; 


Parameters 
TO, SIZE As described in the chapter Tailor. 
See the standard default values in the table GCOS File 
Domain Default Values in the chapter Tailor. 
The maximum size cannot exceed 65535 blocks. 
Rules 


The SYS.SYSDUMP file may be on any resident disk. 


EXAMPLES: 


SYSDUMP TO=RSD SIZE=20000; 
SYSDUMP RSD; 


SYSDUMP SIZE=10200; 


Q 
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The TVMF Command 


Function 


Specifies the location and size of the SYS.TVMF file and checks that it is not 
allocated on a mirrored disk. 


Format 
FSA: 


TVMF [TO={SYS|RSD|RSD1|NRD|NRD1}] [SIZE=digit8]; 


Parameters 
TO As described in the paragraph Principal Parameters. 


See the standard default value in Table 6-1 GCOS File 
Domain Default Values. 


SIZE As described in the paragraph Principal Parameters. 


See the standard default value in Table 6-1 GCOS File 
Domain Default Values. 


See also Calculating Backing-Store File Sizes, in the 
appendix System Files. 


The maximum size cannot exceed 65535 blocks. 


EXAMPLES: 


TVMF TO=NRD SIZE=5000; 
TVMF SIZE=10000; 
TVMF RSD1; 


Q 
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6.7 The DSA Domain 


This Domain, the specific prefix of which is "D", contains the definition commands 
associated with the DSA set of files. 


The DSA file Domain may be accessed by issuing the TLRGEN command, with 
FILESET = DSA. 


In addition to the five disk definition commands covered earlier, this Domain 
contains two commands for defining the characteristics of the frontend processor 
files: generation and operation files. For full details of the files associated with the 
DSA Domain, refer to the chapter DSA Installation and Updating Facility. These 
two file definition commands are: 


e DSALOG 
e DSAFILES 
The EOGEN command, detailed in this chapter, is also applicable. 


6.7.1 Principal Parameters 


The DSA file definition commands both adhere to the same structure. This 
structure uses two main parameters, the descriptions of which are as follows: 


PRES is used to require or prevent the creation of the group 
of files concerned by the command. 


TO is used to specify the location of the group of files 
concerned. Any disk referenced through this 
parameter must have been previously defined through 
the appropriate disk definition command. 


The other parameters used are described with each command. 
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6.7.2 File Definition Commands 


The DSALOG Command 


Function 


To require or prevent creation of the SYS.DSALOGI file and to specify its location 
and size, when access to the DSA network is to be made via a CNP7 or Datanet 
frontend processor. 


Format 
FSA: 


DSALOG [PRES={0|1}] [TO={SYS|RSD|RSD1}] [SIZE=digit8]; 


Parameters 

PRES, TO As described in Paragraph 6.7.1. 
See the standard default values in Table 6-2 DSA File 
Domain Default Values. 

SIZE See the standard default values in Table 6-2 DSA File 
Domain Default Values. 

Rules 


The SYS.DSALOGI file may be located on any disk. 


EXAMPLES: 


DSALOG PRES=1 TO=RSD SIZE=500; 
DSALOG 1 SIZE=800; 


Q 
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The DSAFILES Command 


Function 


To require or prevent creation of the frontend processor files and specify their 
location; these are: 


SYS.DSACONF 

SYS.DSACORE 

SYS.DSADUMP 

SYS.DSABLIB 

SYS.DSALMLIB 

SYS.DSASLIB 

SYS.DSACMD 

SYS.DSATRCIDT_* (for FCP7 only) 


In addition, this command specifies file size for: 


SYS.DSACORE 
SYS.DSADUMP 


For creation of the FCP7-specific files, SYS.DSATRC_<LCT-name>_x, see the 
paragraph The BUILD_TRCNCC Function in the chapter DSA Installation and 
Updating Facility. 


Format 


DSAFILES [PRES={0|1}] [TO={SYS|RSD|RSD1}] [CORESZ=digit8] 
[DUMPSZ=digit8]; 


Parameters 

PRES, TO As described in Paragraph 6.7.1. 

CORESZ is used to specify the size of the SYS.DSACORE file. 
DUMPSZ is used to specify the size of the SYS.DSADUMFP file. 


See the standard default values in Table 6-2 DSA File Domain Default Values. 
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Rules 


SYS.DSA* files are allocated on resident FBO disks. 


EXAMPLES: 


DSAFILES PRES=1 TO=RSD; 


DSAFILES PRES=1 CORESZ=400 DUMPSZ=1000; 


DSAFILES 1 CORESZ=500 DUMPSZ=5000; 


Q) 
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6.8 The OLTD Domain 


This Domain, the specific prefix of which is "O", contains only the commands 
SYSVOL (see Paragraph 6.5) and EOGEN (see Paragraph 6.11), because OLTD 
files have no selectable features. 


The OLTD Domain is accessed using the TLRGEN command, with 
FILESET = OLTD. 
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6.9 The FW Domain 
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This Domain, the specific prefix of which is "F", contains the definition commands 
associated with the linked queued files SYS.FW.* which generate the Firmware. 
The Domain is accessed using the TLRGEN command with FILESET = FW. 


In addition to the five disk definition commands already dealt with, this Domain 
contains the command FWGEN, for defining the location of the group of Firmware 
generation files. 


EOGEN is also applicable. (See Paragraph 6.11.) 


The FWGEN Command 


Function 


To specify the location of the Firmware generation files. 


Format 


FWGEN TO=SYS; 


Parameters 


TO Defines the location of the Firmware generation files. 
The values it may take are the symbolic disk names 
(see disk definition commands). Any disk referenced 
through this parameter must have been previously 
defined through the appropriate disk definition 
command. 


See the standard default value in Table 6-3 FW 
Domain Default Values. 


Rules 


Firmware generation files are allocated on the system disk. 


EXAMPLES: 


FWGEN TO=SYS; 
FWGEN SYS; 


Q 


6-61 


GCOS 7 System Installation Configuration and Updating Guide 


6.10 
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The GSF Domain 


This Domain, the specific prefix of which is "M", contains the definition 
commands associated with the GSF files. This Domain may be accessed using the 
TLRGEN command, with FILESET = GSF. 


In addition to the first three disk definition commands (SYSVOL, RSDVOL and 
RSDVOL]1) dealt with in paragraph 6.5, this Domain contains the command 
GSFGEN for defining the location of the group of GSF files. 


EOGEN is also applicable. (See Paragraph 6.11.) 


The GSFGEN Command 
Function 


To specify the location of the GCOS 7 Service Facility files. 


Format 


GSFGEN TO=SYS; 


Parameters 


TO defines the location of the GCOS 7 Service Facility 
files. The values it may take are the symbolic disk 
names (see disk definition commands). Any disk 
referenced through this parameter must have been 
previously defined through the appropriate disk 
definition command. 


See the standard default value in Table 6-4 GSF 
Domain Default Values. 


Rules 


The GSF files are allocated on the system disk. 


EXAMPLES: 


GSFGEN TO=SYS; 
GSFGEN SYS; 


Q 
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6.11 The EOGEN Command 


This command is available in the five GCL Domains GCOS 7, DSA, OLTD, FW, 
GSF, and is used to exit a Domain, saving the result of the associated TLRGEN 
session. 


Rules 


e The EOGEN command is mandatory ina COMFILE, to end a TLRGEN session. 


e When commands are issued from the user console, the "/" character may be used 
instead of the EOGEN command to exit from a GCL Domain. In this case you 
will be prompted to save the result of the current TLRGEN session. 
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6.12 | TLRGEN Session Considerations 


6.12.1. Summary 


As we have seen in this chapter, a TLRGEN session consists of a sequence of 
commands in any one of the five GCL Domains, GCOS, DSA, OLTD, FW or GSF. 
The purpose of a TLRGEN session is to define file characteristics for a given file 
Domain. 


A TLRGEN session starts with the TLRGEN command, and ends with an EOGEN 
command. 


The result of a TLRGEN session is a set of values constituting the "latest" 
COMSET. For a given Domain, the "latest" COMSET is a merge between the 
previously-active set of default values (which may be itself a "latest" COMSET) 
and those which you have just defined. 


6.12.2 Validation of aTLRGEN Session 


Rules 


e To validate a TLRGEN session, all the disks referenced (through the TO 
parameter) in file definition commands must be defined when activating the 
EOGEN command. 


e The system disk must be defined when ending a TLRGEN session for the GCOS 
or OLTD Domain, even if it has not been referenced in the file definition 
commands. 


e In batch mode, TAILOR aborts if a TLRGEN session is not validated. 


e In interactive mode (from an IOF terminal or the main console), you will be 
prompted until you validate the TLRGEN session. However, you can leave the 
TLRGEN session without saving by using the "/" character. 


NOTE: 
When a TLRGEN session is validated, a TLRPRINT command is activated, by 
default for the current file Domain. 
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6.12.3. Default TLRGEN Sessions 
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If your DPS 7000 system is delivered with a P-Set, you can use a default value set, 
"Last COMSET", to build a Production-Set identical to the delivered P-Set, by 
defining only the characteristics of the system disk. 


This enables a "default" TLRGEN session to be run. This procedure should be 
used whenever possible. 


If the system files for all the Domains (GCOS, FW, OLTD, DSA and GSF) are 
created with their default SIZEs, the space required will exceed the 500 Mbytes 
capacity of the single system disk on which TAILOR tries to locate them by 
default. 


Thus, the user must define another resident disk using the TAILOR command 
RSDVOL and allocate certain system files on this disk. 


For example, files belonging to the DSA Domain and the GCOS Domain files 
SYS.SYSTEM, SYS.LIB, SYS.PVMF and SYS.TVMF could suitably be created 
on this resident disk as follows: 


TLRGEN GCOS INITIAL; 
SYSVOL sysmd sysdvc; 
RSDVOL rsdmd rsddvc; 


ISL TO=RSD; 
LIB TO=RSD; 
PVMF TO=RSD; 
TVMF TO=RSD; 
EOGEN ; 


TLRGEN DSA INITIAL; 
RSDVOL rsdmd rsddvc; 
DSAFILES TO=RSD; 
DSALOG TO=RSD; 
EOGEN; 


6-65 


GCOS 7 System Installation Configuration and Updating Guide 


Once the system disk has been defined through the SYSVOL command, during a 
TLRGEN session for a given files Domain, "latest" COMSETs may be built for the 
other file Domains (for those that do not already have one), by merging the system 
disk definition with the standard default value sets. 


This process should be used whenever possible. 


NOTE: 
After TLRRESET WEAK, if the only disk referenced in the latest COMSETs is 
the system disk, it is also possible to run a default TLRGEN session once the 
system disk has been defined. This is done by merging the incomplete latest 
COMSETs, produced by TLRRESET, with the system disk definition. 


See 6.15.2 for an example of a default TLRGEN session. 


6-66 47 A2 23US 


TAILOR 


6.13 Context Rules 


6.13.1 TAILOR and IUF 


TAILOR CALLED BY GIUF FUNCTIONS 
In an IUF context, the TAILOR processor may be called by several functions: 


e BUILDP, to create or complete your P-Sets. According to the IUF configuration, 
the input Set will be: 
— The P2-Set, in a P2P configuration. 
— The R-Set, in an RP configuration 


e BUILDP2, to create or complete a P2-Set from a P-Set. The First BUILDP2 
activation modifies the IUF configuration from RP to P2P. 


CREATING OR UPDATING PRODUCTION SETS 
When TAILOR is called by IUF functions, there are two possible situations: 


e You are creating a Production Set: 


From TAILOR's point of view, this is equivalent to a TLREXEC command for 
the GCOS file Domain. The resulting production Set must reflect the content of 
the input Set. For this reason, a check is made, before starting file creation, that 
TLREXEC commands have been issued for all the file Domains available on the 
input Set. 


If such commands are missing, an abort will occur when TAILOR commands 
are read from a COMFILE. If commands are given either at the main console or 
at an IOF terminal, it will be impossible to interrupt the dialogue as long as 
TLREXEC commands are missing. 


e You are completing an existing Production Set: 


This might be as a consequence of an add-on. From TAILOR's point of view, no 
TLREXEC command for the GCOS Domain has been activated, so no check is 
made. 
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6.13.2 
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RESTART After Abort During File Creation 


ORDER OF CREATION 
Note that the file Domains are always created by TAILOR in the same order: 


1. GCOS Domain 


2. OLTD Domain 
3. FW Domain 

4. DSA Domain 
5. GSF Domain. 


The TLREXEC commands for the five file Domains may be given in any order, but 
in the event of restart after an abort, it is necessary to reissue the TLTREXEC 
commands for the file Domains that have not yet been created. For example, to 
create a Production Set containing the GCOS, OLTD, DSA, GSF and FW file 
Domains, an appropriate TAILOR command sequence might be: 


TLREXEC GCOS; 
TLREXEC DSA; 
TLREXEC OLTD; 
T 
T 


LREXEC FW; 
LREXEC GSF; 


If an abort occurred during OLTD file creation at label O5, the sequence of 
TLREXEC commands in TAILOR necessary to restart file creation would be: 


TLREXEC OLTD FROM=05; (to restart OLTD file creation) 
TLREXEC DSA; (the DSA, GSF and FW files 
TLREXEC FW; had not yet been created 
TLREXEC GSF; at the time of the abort) 


CONTROL OF FILE LOCATION 


Before restarting file creation after an abort, a check is made to verify that no file 
location has been changed as compared with the initial launch; changing location 
means changing the value of the PRES or TO parameters in the command 
associated with a given file. 


If such changes are detected, RESTART is not performed until the old locations 
have been restored. 
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6.14 GCL Rules 


You will find it helpful when using TAILOR and you need to issue commands from 
a console (MAIN or IOF), to keep in mind some specific GCL rules: 


e The "/" character is used to notify the end of the current action. It may be used 
to leave prompting mode for a given command, or to leave a GCL Domain. 


e The "?" character is used to require help, and may be used at Domain level, at 
command level, or at keyword level. 


e Prompting mode is entered if you make syntax errors, or if you give incomplete 
commands (for example, command name followed only by a semi-colon). 
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6.15 Examples 


6.15.1 TLRGEN Session 


The following example represents, for each Domain: 


1. the TAILOR commands, for batch processing mode 


2. the output that appears on the terminal screen. 


GCOS Domain 
1. TAILOR Commands 


T: TLRRESET STRONG; 


>>> SUCCESSFUL RESET 

T: TLRGEN FILESET=GCOS; 

G: SYSVOL MD=FSD02 DVC=MS/FSA; 
G: RSDVOL MD=FSD03 DVC=MS/FSA; 
G: NRDVOL MD=FSD04 DVC=MS/FSA; 
G: SYO SPLIT=(RSD:3); 

G: JBEFORE PRES=1; 

G: BKST1 SYS SIZE=17000 TO=RSD; 
G: MIRLOG 1 NRD; 

G: HALOCK 1 SYS; 

G: EOGEN; 

NOTE: 


The commands actually submitted are as shown above (G: is the GCL prompt). 
These are followed by: 


PRINT OF TL_GCOS DOMAIN STATUS 


The TLRPRINT command does not have to be submitted. It is implicitly 
activated at the end of a TLRGEN session. The result is as follows: 
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2. Output 


VOLUME STATUS 


TAILOR 


COMNAME MEDIA DEVCLAS ORG | MIRROR 
RSDVOL FSDO03 MS/FSA FSA N 
RSDVOL1 UNDEF UNDEF 
NRDVOL FSD04 MS/FSA FSA N 
NRDVOL1 UNDEF UNDEF 
SYSVOL FSDO02 MS/FSA FSA N 
CATVOL UNDEF UNDEF 
COPIED FILES STATUS 
COMNAME FILENAME LOADED ON 
ISL SYS. SYSTEM YES SsYs 
PREALLOCATED FILES STATUS 
CREA INC | MAX | BLK | REC) LT 
COs acacia TED | ON SIZE sz | sz sz | sz | sz 
CATFL SITE.CATALOG YES | SYS 1940 BLK 
SITIN SLTE, IN NO 
STUP SITE. STARTUP YES | SYS 170 BLK 
BKST SYS.BKST YES | SYS 
BKST1 SYS.BKST1 YES | RSD1/|17000 BLK 
ERLOG SYS.ERLOG YES | SYS 85 BLK 
SYIN SYS:)...N YES | SYS 170 BLK)/170 680 
JBEFORE | SYS.JRNAL YES | SYS | 16368 BLK 
KNODET SYS .KNODET YES | SYS 85 BLK 
LOGC SYS .LOGC YES | SYS 240 BLK 
SYO SYS.OUT YES | SYS 340 BLK 
RSD 8 cyl] 85/32000]8166|4024) 5 
SPOOL SYS.SPOOLO YES | SYS 510 BLK 2 600|]8116/4024| 5 
SYSDUMP | SYS.SYSDUMP YES | SYS 11730 BLK 
SWLOG SYS.SWLOG YES | SYS 
LIB SYS.LIB YES | SYS |11900 BLK 
PVMF SYS.PVMF YES | SYS 5100 BLK 
TVMF SYS.TVMF YES | SYS 2550 BLK 
SITHELP | SITE.HELP YES | SYS 170 BLK 
QM SYS.QM YES |: SYS 500 CL 
QMBACK SYS.QM BACKUP YES | SYS 500 CI 
MIRLOG SITE.MIRLOG YES | NRD 
JAS SYS .JASBLUE NO 
JAS SYS .JASGREEN NO 
CLC SYS.CLC NO 
CMS SITE.CMS-CSD NO 
CMS SITE.CMS-CDD-namel NO 
CMS SITE.CMS-CDD-name2 NO 
CMS SITE.CMS-DS-namel-name2 | NO 
HALOCK SITE.HALOCK YES | SYS 
SPDUMP SYS.SPDUMP YES | SYS 
UNITS OF SIZE, INCSZ, MAXSZ ARE THE SAME 


>>>COMPLETED TLRGEN SESSION. 
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GSF Domain 
1. TAILOR Commands 
: TLRGEN GSF; 


SYSVOL FSD02 MS/FSA; 
: EOGEN; 


er 


2. Output 


VOLUMES STATUS 


COMNAME MEDIA DEVCLASS ORG MIRROR 

SYSVOL FSDO2 MS/FSA FSA N 
COPIED FILES STATUS 

COMNAME FILENAME LOADED ON 

GSFGEN GSFGEN_FILES YES SYS 
OLTD Domain 


1. TAILOR Commands 


T: TLRGEN OLTD; 
O: EOGEN; 
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2. 


Output 


VOLUMES STATUS 


TAILOR 


COMNAME MEDIA DEVCLASS ORG MIRROR 
SYSVOL FSDO02 MS/FSA FSA N 
FW Domain 
1. TAILOR Commands 
T: TLRGEN FW; 
F: SYSVOL FSD02 MS/FSA; 
F: EOGEN; 
2. Output 
VOLUME STATUS 
COMNAME MEDIA DEVCLASS ORG MIRROR 
SYSVOL FSD02 MS/FSA FSA N 
COPIED FILES STATUS 
COMNAME FILENAME LOADED ON 
FWGEN FWGEN_FILES YES SYS 
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VOLUME STATUS 


DSA Domain 


1. 


2. 


TAILOR Commands 


: TLRGEN DSA; 
: SYSVOL FSD02 MS/FSA; 
: EOGEN; 


Output 


COMNAME MEDIA DEVCLASS ORG MIRROR 
SYSVOL FSD02 MS/FSA FSA N 
COPIED FILES STATUS 
COMNAME FILENAME LOADED ON 
DSAFILES SYS.DSA* FILES YES SYS 
PREALLOCATED FILES STATUS 
CREA MAX | BLK | REC LT 
AM. 
COMNAME FILENAME TED ON SIZE INCS Sz Sz Sz Sz 
DSAFILE SYS.DSACONF | YES | SYS | 340 BLK 
DSAFILE SYS.DSACORE | YES | SYS | 340 BLK 
DSAFILE SYS.DSADUMP | YES | SYS /1360 BLK 
DSALOG SYS.DSALOG1 | YES | SYS | 680 BLK 
UNITS OF SIZE, INCSZ, MAXSZ ARE THE SAME. 
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6.15.2 Default TLRGEN Session 


This example shows the status of the "latest" COMSETs after the TLRGEN session 
described in the first example. At the end of the TLRGEN session performed for 
the GCOS files Domain, "latest" COMSETs have been constituted by merging the 
SYSVOL definition with the initial COMSETs for the DSA, OLTD, GSF and FW 
file Domains. 


T: TLRSTAT; 
TAILOR PROCESSING STATUS : 


FILESET EXECUTABLE TO BE BUILT 


GCOS YES NO Default TLRGEN sessions for FW, OLTD, 
FW YES NO GSF and DSA Domains have been 

OLTD YES NO performed which allow TLREXEC 

DSA YES NO activation for these Domains. 

GSF YES NO 
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6.15.3  TLREXEC Command Sequences 


This example describes two sequences of TLREXEC commands: the first 
launching the creation of several Domains, the second restarting creation after an 
abort. It is assumed that a TLRGEN session has been performed for the Domains 
to be created (see the above examples). 


T: TLREXEC GCOS; 
>>> TAILOR READY TO 


UILD GCOS DOMAIN FILES 


T: TLREXEC DSA; 
>>> TAILOR READY TO 


UILD DSA DOMAIN FILES 


T: TLREXEC FW; 
>>> TAILOR READY TO 


UILD FW DOMAIN FILES 


T: TLREXEC OLTD; 
>>> TAILOR READY TO 


UILD OLTD DOMAIN FILES 


T: TLREXEC GSF; 
>>> TAILOR READY TO 


UILD GSF DOMAIN FILES 


T: TLRSTAT; 


FILESET EXECUTABLE 


GCOS YES 
FW YES 
OLTD YES 
DSA YES 
GSF YES 
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TAILOR PROCESSING STATUS 


TO BE BUILT 


YES 
YES 
YES 
YES 
YES 
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Suppose that an abort now occurs during GCOS 7 file creation at label G15. After 
correcting any errors, by performing a TLRGEN session with FILESET = GCOS 
and COMSET = LAST, an appropriate sequence for restarting creation would be as 
follows: 


T: TLREXEC GCOS FROM=G15; 

>>> TAILOR READY TO BUILD GCOS DOMAIN FILES 
T: TLREXEC DSA; 

>>> TATLOR READY TO BUILD DSA DOMAIN FILES 
T: TLREXEC OLTD; 

>>> TAILOR READY TO BUILD OLTD DOMAIN FILES 
T: TLREXEC FW; 

>>> TAILOR READY TO BUILD FW DOMAIN FILES 
T: TLREXEC GSF; 

>>> TATLOR READY TO BUILD GSF DOMAIN FILES 
NOTE: 


TLREXEC commands are mandatory for the FW, DSA, GSF and OLTD file 
Domains, because these have not yet been created. 
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6.15.4 Dialogue at the MAIN Console 


The following gives an example of the dialogue when commands are issued from 
the main console. In this case, the answers to prompts are given in deferred mode, 
preceded by the answer number. 


>>>12.37 TAILOR 11.01 
O1/T: 

S:01 TLRRESET STRONG; 
--->>>> SUCCESSFUL RESET 
02/T: 
S:02 TLRGEN GCOS INITIAL; 

03/G: 

S:03 SYSVOL K111 MS/FSA; 

---> ? 

---> SYSVOL MUST BE IN FSA ORGANIZATION 

04/MEDIA 

S:04 K333 

05/DVC 

S:05 MS/FSA 

06/G: 

S:06 RSDVOL K222; 

07/G: 

S:07 STUP PRES=1 TO=NRD; 

---> ? 

---> LOCATION MUST BE A RESIDENT DISK 

08/TO LOCATION (NRD) 

S:08 RSD 

09/G: 

S:09 JBEFORE; 

—-->JBEFORE 

0/PRES REQUIRED CREATION (BOOLEAN VALUE) (0) 

S2.0. 1. 

11/TO LOCATION (SYS) 

S:11 

2/SIZE SIZE IN CYLINDERS (10) 

S:12 12 

3/FILEBLOCK_SIZE FILE BLOCK SIZE IN BYTES (512 or 4096) (512): 
S:13 

14/G: 

S:14 EOGEN; 


Then, as in interactive mode, an implicit TLRPRINT command is activated. 
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6.15.5 Examples of Errors 


47 A2 23US 


The following examples describe some error sequences with the corresponding 
error messages. 


VOLUME REFERENCED BUT UNDEFINED 


This example describes the case where an undefined disk is referenced in a file 
definition command. In this case, the command is aborted. 


T: TLRRESET STRONG; 

>>> SUCCESSFUL RESET 

T: TLRGEN GCOS INITIAL; 

G: SYSVOL FSAI MS/FSA; 

G: ERLOG PRES=1 TO=RSD; 

*** RSDVOL REFERENCED AND NOT DEFINED 

>>> ABORTED TLRGEN SESSION (only in batch mode) 
>>> ABORTED TAILOR (only in batch mode) 


NO LATEST COMSET EXISTS 


After a TLRRESET STRONG command, all "latest" COMSETs are cleared and 
thus unavailable for use in a TLRGEN session. 


T: TLRRESET STRONG; 

>>> SUCCESSFUL RESET 

T: TLRGEN GCOS COMSET=LAST; 

***NO EXISTING LAST FOR GCOS FILESET 

>>> ABORTED TLRGEN SESSION (only in batch mode) 
>>> ABORTED TAILOR (only in batch mode) 
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ERRONEOUS VALUE FOR SPLIT 


This example describes the case where the SYS.OUT file is located on several 
disks and the same volume name is specified for each location: 


T: TLRRESET STRONG; 

>>> SUCCESSFUL RESET 

T: TLRGEN GCOS INITIAL; 

G: SYSVOL FSA1 MS/FSA; 

G: SYO TO=SYS SPLIT=(SYS:510) ; 

*** TNVALID VALUE FOR SPLIT: SYSVOL CANNOT BE 
REFERENCED SEVERAL TIMES 

>>> ABORTED TLRGEN SESSION 

>>> ABORTED TAILOR 
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6.16 TAILOR Default Values and File Size Computation 


6.16.1 GCOS File Domain 


Table 6-1. GCOS File Domain Default Values (1/4) 
Command Parameter Default Value MS/FSA 
BKST SIZE 15980 
PRES 0 
BKST1 TO SYS 
SIZE 4250 
PRES 1 
CATFL TO SYS 
NBOBJ 1940 
PRES 0 
CLC 
TO SYS 
PRES 0 
TO RSD 
CMS 
NAME1 XXXX 
NAME2 YYYY 
PRES 1 
ERLOG 
TO SYS 
PRES 0 
HALOCK 
TO RSD 
ISL TO SYS 
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Table 6-1. GCOS File Domain Default Values (2/4) 


Command Parameter Default Value MS/FSA 
PRES 0 
TO SYS 
SIZE 10 
JOURNAL_ SIZE 80 
JAFTER BLOCK_SIZE 8192 
PRIMARY_MEDIA NIL 
PRIMARY_DVC NIL 
SECONDARY_MEDIA NIL 
SECONDARY_DVC NIL 
AUTOCYCLE 1 
SECDCOPY 0 
PRES 0 
JAS 
TO SYS 
PRES 1 
JBEFORE TO SYS 
SIZE 16368 
FILEBLOCK_SIZE 512 
TO SYS 
KNODET 
SIZE 85 
TO SYS 
nF SIZE 11900 
PRES 1 
LOGC 
TO SYS 
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Table 6-1. GCOS File Domain Default Values (3/4) 


Command Parameter Default Value MS/FSA 


PRES 0 
MIRLOG 
TO SYS 
TO SYS 
a SIZE 5100 
TO SYS 
QM 
SIZE 500 
TO SYS 
QMBACK 
SIZE 500 
PRES 1 
SITHELP TO SYS 
SIZE 170 
PRES 0 
SITIN TO SYS 
SIZE 170 
SPDUMP TO SYS 
TO SYS 
SPOOL 
SIZE 1360 
PRES 1 
STUP TO SYS 
SIZE 170 
SWLOG TO SYS 
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Table 6-1. GCOS File Domain Default Values (4/4) 


Command Parameter Default Value MS/FSA 
SIZE 170 
SYSIN INCRSIZE 170 
MAXSIZE 680 
PRES 1 
TO SYS 
SIZE 340 
SPLIT UNDEF 
SYO INCRSIZE 85 
MAXSIZE 32000 
BLKSZ 8116 
RECSIZE 4024 
LTKSZ 5 
SYSDUMP _ sl 
SIZE 11730 
TO SYS 
TVMF 
SIZE 2550 
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6.16.2 DSA File Domain 


STANDARD DEFAULT VALUES 


TAILOR 


Table 6-2. DSA File Domain Default Value 


Command Parameter 


PRES 
DSALOG TO 
SIZE 
PRES 
TO 
DSAFILES 
CORESZ 


DUMPSZ 
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Default Value MS/FSA 


1 


SYS 


680 blocks 


1 


SYS 


340 blocks 


7200 blocks 
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6.16.3 FW File Domain 


STANDARD DEFAULT VALUES 


Table 6-3. 


Command 


FWGEN 


6.16.4 GSF File Domain 


Parameter 


TO 


FW File Domain Default Values 


Default Value MS/FSA 


SYS 


STANDARD DEFAULT VALUES 


Table 6-4. GSF File Domain Default Values 
Command Parameter Default Value MS/FSA 
GSFGEN TO SYS 
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6.17 Catalog Files: Size and Number of Objects 


Table 6-5. File Size and Number of Objects on MS/FSA Volume 


Number of Logical Blocks in the catalog Number of Objects 

6 45 (min.) 
11 100 
88 1000 
433 5000 
866 10000 
1728 20000 
2590 30000 
3454 40000 
4316 50000 
5179 60000 
6042 70000 
6905 80000 
7766 90000 

8629 100000 (max.) 


NOTES: 


1. The number of blocks in a subcatalog may be obtained through the LSCAT 
and CATLIST requests. 


2. The size of a catalog block is 4096 bytes on MS/FSA. 
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7. Updating Domains 


Purpose 


Updating procedures enable you to perform preventative maintenance on the 
following Domains: 


e GCOS 
e OLTD 
e FW 

e DSA 
e GSF. 


This is done by applying a new Technical Status to the Domain concerned. 


For the GCOS Domain, your Bull CSE provides a G-MEDIA, which can be either 
tapes or cartridges containing the GCOS 7 system files used by both the 
Installation and Updating procedures. As a general rule, the Set to be updated is: 


e the P-Set, in a PO-Configuration or an RP-Configuration 
e the chosen Set (non-running or running) in a P2P-Configuration. 


In P2P and RP-Configurations, the other Set may be updated using the IUF 
function LEVEL, after a probationary period of time. 


The operations to be performed are described in the updating procedure relevant to 
each of the Domains: GCOS, OLTD, FW, DSA and GSF. 


For slave system updating, refer to the chapter Multi-System Installation and 
Updating. 
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7.2 Set Technical Level 


The number of its Technical Status indicates the Technical Level of a P-Set, P2-Set, 
or R-Set, for each Domain. 


The application of a new Technical Status to a Set modifies the updated Domain's 
Technical Status Number (TSN). 


7.3 Updating Strategy in a PO-Configuration 


After Release installation has been completed, the only system Set is the P-Set. 


The UPDATE_GCOS function applies TS corrections to the running P-Set. 


G-MEDIA \— UPDATE_GCOS 
\ y P-Set 


Running Set 


Figure 7-1. Updating Strategy in a PO-Configuration 
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7.4 Updating Strategy in a P2P-Configuration 
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After Release installation, the P-Set and P2-Set are at the same Technical Level (as 
a result of running the BUILDP2 function). 


In a P2P-Configuration, the default value of the updated Set is the non-running Set. 
However, the OUTSET parameter of the IUF function UPDATE GCOS provides 
the possibility of updating the running Set 


The update function applies TS corrections to either the running or the non-running 
Set (P-Set or P2-Set), allowing the user to execute the updating procedure without 
any risk for the running Set. 


After the updated Set has been loaded, the After Journal environment and the 
SITE.CATALOG must, as appropriate, be transferred from the old Set to the new 
Set. 


During the probationary period of the new update, returning to the previous update 
is very fast, because it is only necessary to perform a warm restart on the other 
(reserve) Set. 


When the probationary period is over, or just before applying a new update, the 
LEVEL function must be executed, to bring both Sets up to the same Technical 
Level. 


G-MEDIA a P-Set q P2-Set 
een fe re LEVEL = 
—— P-Set 
P2-Set \ 
Non Updated Set 
Updated Set 


Figure 7-2. Updating Strategy in a P2P-Configuration 
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7.5 Updating Strategy in an RP-Configuration 


After installation of a new Release, the R-Set and P-Set are at the same Technical 
Level (as a result of the BUILDP function). 


The update function applies TS corrections to the P-Set only. After the application 
of a new Technical Status, the R-Set remains unchanged until the next execution of 
the UPDATE GCOS function. Refer to the chapter Installation and Updating 
Facility. 


Note that it is not possible to create a new P-Set while the R-Set is at a lower 
Technical Level than the P-Set. The R-Set is brought up to the same Technical 
Level as that of the P-Set by running the LEVEL function. 


The LEVEL function may also be used for back-up purposes, to bring a P-Set back 
to the same Technical Level as that of the R-Set, in case of a failure on the P-Set 
files affected by the UPDATE _GCOS function. 


UPDATE_GCOS > 


-MEDIA 
aren, > —-~P-Set EEXER| -iRsSet 
aa . 


Running Set 


Figure 7-3. Updating Strategy in an RP-Configuration 


For Domains other than GCOS, refer respectively to: 

e for FW, the chapter FGF (Firmware Generation Facility) 
e for OLTD, the chapter The TDF Facility (OLTD) 

e for DSA, the chapter The DIUF Facility 

e for GSF, the chapter The GSF Facility. 
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Table 7-1. 


GCOS 7 Updating Procedure 


File 
Replace 


Module 
Replace 


SYS.BOOT 


SYS.C.INCLUDE 
SYS.GPL.MACLIB 


SYS.HBINLIB 
SYS.HCULIB 
SYS.HELP 
SYS.HLMLIB 
SYS.HSLLIB 
SYS.IUF 
SYS.SYSTEM 


* 


(1) 


(1) This file is modified in a specific way. 


Updating Domains 


Files in PO-Configurations Affected by UPDATE_GCOS 


Table 7-2. Files in P2P & RP-Configurations Affected by 
UPDATE_GCOS 


File 
Replace 


Module 
Replace 


SYS.BOOT 


SYS.C.INCLUDE 
SYS.GPL.MACLIB 


SYS.HBINLIB 
SYS.HCULIB 
SYS.HELP 
SYS.HLMLIB 
SYS.HSLLIB 
SYS.IUF 
SYS.SYSTEM 


(1) 


(1) This file is modified in a specific way. 


In P2P and RP-Configurations, both Sets must be present during execution of the 


UPDATE_GCOS function. 


In RP-Configurations, the UPDATE_GCOS function performs an automatic 
LEVEL from the P-Set to the R-Set. 
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(2): 


bs 
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IMPORTANT: 


UPDATE_GCOS must be submitted under the SYSADMIN project. 


In a PO-Configuration, in the event of the SYS.SYSTEM file becoming 
corrupted, there is no possibility of salvaging this file from the SYS.SYSTEM 
on another Set. The only solution is to take regular saves of the P-Set, and use 
the backup procedure outlined in the chapter /nstallation Procedure, in order to 
restore the SYS.SYSTEM file. 


The UPDATE_GCOS function must be performed in a monoprogramming 
environment when the Technical Status is applied on the running Set. There is a 
risk involved in performing this IUF function in a multiprogramming 
environment as several system files may be dynamically changed in the process. 


The following functions must never be performed while TDS is active: 


- UPDATE_GCOS 
- LEVEL GCOS 

- LEVEL ALL 

- RESTORE SET GCOS 
- RESTORE SET ALL 


This is because TDS assigns itself exclusive access to the file SYS.HBINLIB, 
which would result in aborting the UPDATE GCOS session (without a restart 
point) at the moment when it tries to update the SYS.HBINLIB library. 


After application of a new Technical Status (using UPDATE GCOS), the 
RESTART(CLEAN) command should be executed before regenerating TDS. 


47 A2 23US 


Updating Domains 


7.7 GCOS 7 Updating Operations 
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The P-Set or the P2-Set must be loaded and running. 


1. 


In the case of a PO Set (or, for a P2P-Configuration, the Set to be updated, 
either the running or the non-running Set) on line. The Set to be updated must 
be on line so that the system can return its current Technical Level before you 
apply the TS corrections. 


In the case of an RP-Configuration, put the R-Set on line. The R-Set must be 
on line so that the system can return the R-Set's current Technical Level as 
well as to permit the UPDATE GCOS function to perform an automatic 
LEVEL from P-Set to R-Set. 


Mount the G-MEDIA. 


The G-MEDIA is either a set of tapes or cartridges containing the GCOS 7 
files, or a CD-ROM (only available for XTA Systems).In this later case, the 
image of the GCOS 7 Technical Status, will be transferred to a work disk 
using the Install GCOS TECHNICAL STATUS script located on the 
CD-ROM. 


Start the [UF function UPDATE GCOS. 


For details of the UPDATE GCOS function, refer to the chapter The 
Installation and Updating Facility (paragraph 4.2.39). 


End the system. 


Completely reinitialize the system, then load GCOS 7 from the updated disk 
Set. If ISL is redelivered, all the parameters have to be re-specified. 
Otherwise it is sufficient to proceed as follows: 


I: RESTORE,RESTART(CLEAN) 
For the ISL parameters, refer to the GCOS 7 System Operator's Guide. 
In the case of a P2P-Configuration: 


The After Journal environment must be transferred from the old Set to the 
new (updated) Set. 


The After Journal environment is transferred using the procedure described in 
below. 


The SITE.CATALOG may be updated, as necessary, from the old Set using 
the COPY SITEFILES function. 


Save the P-Set with the SAVE_DISK command. 


You will then be able to recover your P-Set using RESTORE under the SIP 
facility in UTIL mode (see the appendix S7P Functions). 
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7.8 After Journal Transfer 


This operation can be performed only when there is no activity on the After 
Journal. Its purpose is to copy the SYS.JADIR file from the old Set to the new Set 
which is now to be used, and to move the name path of the SYS.JADIR file from 
the SYS.CATALOG in the old Set to the SYS.CATALOG in the Set now to be 
used. 


The following GCL and JCL must be executed under the project SYSADMIN: 


S: ATTACH (CAT=SYS.CATALOG:new-set-md:new-set-dvc, 
SYS.CATALOG: old-set-md:o0ld-set-dvc) ; 


S: COPY_FILE INFILE=SYS .JADIR$CAT2 
OUTFILE=SYS .JADIR DYNALC=CAT1 ; 


In batch mode only: 


SJOB jobname; 


ATTACH (CAT1=SYS.CATALOG: new-set-md: new-set-dvc, 
CAT2=SYS.CATALOG: old-set-md: old-set-dvc) ; 


CATMOVE FROM=SYS.JA 
INFILE=(SYS.CATALOG CAT=2 
OUTFILE=(SYS.CATALOG CAT=1) 
REPLACE; 


SENDJOB ; 


NOTE: 
The JCL commands CATMOVE, CATPRINT and CATCHECK cannot be used 
in interactive mode. 


12s IMPORTANT: 


The first SYS.CATALOG file to be attached must be the SYS.CATALOG of the 
running system. 


7-8 47 A2 23US 


8. Patching Procedures 


8.1 Purpose 


These Patching procedures enable you to perform corrective maintenance on the 
GCOS and DSA Domains. 


This is done with an EC-MEDIA containing one or several word corrections 
provided by the Local Distribution Center or by your Bull CSE. 


These corrections, called EC (Emergency Corrections), may be applied to any 
running or non-running Set: P-Set, P2-Set, or R-Set. 


The Patching procedures described in this chapter concern the GCOS Domain only. 
For the Patching procedures of the DSA Domain, refer to the chapter DSA 
Installation and Updating Facility. 


There are no Patching procedures for the FW, OLTD and GSF Domains. 


8.2 GCOS 7 Patching Procedure 


The GCOS 7 files that may be modified using Emergency Corrections, are 
SYS.HLMLIB and SYS.SYSTEM. 


This function should be used only at the request of your Bull CSE. 
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8.3 Operations 


1. 


8-2 


Make available the Set to be updated. 


The Set to be updated may be running or not, depending on the IUF 
configuration. 


Mount the EC-MEDIA, if any. 


Start the IUF function PATCH _HLMLIB or PATCH_SYSTEM, depending on 
whether the EC is to be applied to the SYS.HLMLIB or SYS.SYSTEM file. 


For details of the IUF functions PATCH _HLMLIB and PATCH_SYSTEM, 
refer to chapter /nstallation and Updating Facility. 


If PATCH SYSTEM function has been used, the updated SYS.SYSTEM must 
be restored, as follows: 


I: RESTORE 


For other ISL parameters, refer to the GCOS 7 System Operator's Guide. 


If the PATCH HLMLIB function has been used, the updated Load Modules 
must be cleared from backing store if they are preinitialized. 


This is done in one of two ways: 


a. The command MDC CLM followed by MDC PLM 


b. The command RESTART (CLEAN) followed by the command MDC 
PLM. 
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Patching Procedures 


EC-MEDIA 


PATCH_SYSTEM or 
PATCH_HLMLIB, 
as appropriate 


v 

; Non- 
Resident Resident 

Disk : 
None Disk 
Resident ; 
Disk y Resident 
/ Disk 
System 
Disk 
Updated Set 
Figure 8-1. GCOS 7 Patching Procedures 
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9. Firmware Generation (FGF) and Test and 
Diagnostics (OLTD) Facilities 


9.1 Introduction 


Your Bull CSE uses these facilities to install the FW (Firmware) and OLTD 
(On-Line Tests & Diagnostics) Domains. 


9.2 FGF (Firmware Generation Facility) 


The Firmware Generation Facility is used to install and maintain all the 
components of the FW (Firmware) Domain on the P-Set, P2-Set, or R-Set, as 
appropriate. 


There are two separate cases of Firmware installation. 


e Installation on a new system: 


Initial firmware installation is performed on the P-Set. The FW Domain can 
then be automatically transferred to the P2-Set or the R-Set as appropriate: 


— for a P2P-Configuration, to the P2-Set, using the GIUF function BUILDP2, 
— for an RP-Configuration, to the R-Set, using the GIUF job INSTAL_RSET. 
e Installation of a new Firmware release on an existing system: 


Installation is performed on the running Set (P-, P2-, or R-Set, as appropriate to 
the Configuration type). The non-updated Sets may be subsequently brought up 
to the level of the new version by using the GIUF function LEVEL. 
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9.3 TDF (Tests and Diagnostics Facility) 


9.3.1 DPS 7000 (except DPS 7000/XTA) 


The TDF (Tests and Diagnostics Facility) is used to install and maintain all the 
components of the OLTD (On-Line Tests & Diagnostics) Domain on the P-Set, 
P2-Set, or R-Set, as appropriate, There are two separate cases of Firmware 
installation: 


e installation on a new system. 


Initial installation is performed on the P-Set. The OLTDs can then be 
automatically transferred to the P2-Set or the R-Set as appropriate: 


— for a P2P-Configuration, to the P2-Set, using the GIUF function BUILDP2, 
— for an RP-Configuration, to the R-Set, using the GIUF job INSTAL_RSET. 
e installation of a new release on an existing system. 


Installation is performed on the running Set (P-, P2-, or R-Set, as appropriate to 
the Configuration type). The non-updated Sets may be subsequently brought up 
to the level of the new version by using the GIUF function LEVEL. 


9.3.2 DPS 7000/XTA 


The TDF ‘Tests and Diagnostics Facility) is now obsolete. 


The necessary files are included and managed by the BSR tools (FGF) for 
compatibility reasons with GIUF. 
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10. DSA Installation and Updating Facility 


10.1 Introduction 
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DIUF (DSA Installation and Updating Facility) is for the installation and 
maintenance of the telecommunications-related software and files on your system. 
The associated system files, for storing: 


e the Datanet DNS software and/or 
e CNS 7 software for CNP 7 and/or 
e the FCP 7 software 


belong to the DSA system file Domain. 


This facility enables you to install and maintain all the components of the DSA 
system file Domain on the P-Set, P2-Set, R-Set as appropriate. 


DIUF supports: 


e The management of several versions of DNS and/or CNS 7 and/or FCP 7 ona 
single site at the same time. 


e The application of source corrections to a Technical Status delivery. 


NOTE: 
DSA Domain files are to be installed on FBO volumes only, except: 
SYS.DSALOGi 
SYS.DSATRC_ <Ict-name>_x 
SYS.DSATRCIDX_<Ict-name> 
which may be allocated on FBO or VBO volumes. 
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10.2 
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Environment 


The system files for the DSA Domain are cataloged in the SYS.CATALOG file. 
Created by the DIUF Facility: 


SYS.DSABLIB 
SYS.DSASLIB 
SYS.DSALMLIB 


Created by BUILDP & BUILDP2: 


SYS.DSACONF 

SYS.DSACORE 

SYS.DSADUMP 

SYS.DSALOGI 

SYS.DSACMD 

SYS.DSATRC_ <Ict-name>_x 
(FCP 7-specific, where Ict-name=name of Local 
Communication Controller and 1 <= x <= 9). 

SYS.DSATRCIDT_ <fcp-ts> — (<fcp-ts>=Nxyy for not XTA systems and <fcp- 
ts>=Dxyy for XTA systems). 


In a PO-Configuration, all the DSA Domain files are created by the DIUF function 
INSTAL, except: 


e the SYS.DSATRC_<fcp-ts> file (created only if the Nxxy Technical Status is 
installed), 


e the SYS.DSATRC <Ict-name>_x files (created by the DIUF function 
BUILD_TRCNCC). 


In an RP or P2P-Configuration, only the SYS.DSABLIB and SYS.DSASLIB files 
(plus SYS.DSALMLIB _<fcp-ts> if the Nxyy Technical Status of FCP 7 is 
installed) are created by the DIUF function INSTAL. 


In addition to creating the SYS.DSACONF, SYS.DSACORE, SYS.DSADUMP, 
SYS.DSALOGI1 and SYS.DSACMD files, the GIUF functions BUILDP and 
BUILDP2 are also used for copying the SYS.DSABLIB, SYS.DSASLIB, 
SYS.DSALMLIB and existing SYS.DSATRCIDT_<fcp-ts> files. 


The GIUF function LEVEL also copies the SYS.DSABLIB, SYS.DSASLIB, 
SYS.DSALMLIB, and existing SYS.DSATRCIDT_<fcp-ts> files. 


The SYS.DSATRC <Ict-name>_x files must be created by the DIUF function 
BUILD_TRCNCC if FCP 7 is installed. 
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10.2.1 R-Set Considerations 


You are strongly recommended to run under a P2P-Configuration. One of the 
reasons for this is that the R-Set cannot be used to run telecommunications. This 
means that the following files are not created on the R-Set: 


SYS.DSACONF, SYS.DSACORE, SYS.DSADUMP, SYS.DSACMD, 
SYS.DSALOGI, SYS.DSATRC_<Ict-name>_x and SYS.DSATRCIDT_<fcp-ts> 
files 


10.2.2 DNS/CNS/FCP 7 Media 
New Technical Statuses of CNS, DNS, or FCP 7 are either included in the 


DOMAINS-MEDIA, which is supplied by the factory, or are on separate media 
supplied by your Bull CSE. 


10.2.3 Technical Statuses and Releases 
The first two characters of the Technical Status identifier correspond to the Release 


number. A new Technical Status to be installed, for which no Technical Status of 
the same Release is already installed, is called a new Release. 
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10.3 DIUF Tools 


The IOF user may access the DIUF Facility by using the GCL command 
ENTER_DIUF, which provides the following facilities: 


INSTAL 


UPDATE 


PATCH 


DELETE_TS 


LIST 


LOADFACT 


BUILD_TRCNCC 
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is used to install anew DNS/CNS 7/FCP 7 Release, 
and to install a Technical Status but without bringing 
forward any site-specific corrections. This procedure 
is required when installing a new DNS, CNS 7, or FCP 
7 Release for the first time in the DSA Domain. 


is used to install a new Technical Status on an 
already-installed DNS, CNS 7, or FCP 7 Release, with 
optional bringing forward of site-specific corrections, 
provided that all the files for the DSA Domain have 
already been created. This procedure may also be used 
for installing a new Release, or a new Technical Status 
without bringing forward any site-specific corrections. 
An already-installed Technical Status cannot be 
re-installed with the UPDATE function. 


is used to apply emergency corrections to an 
already-installed DNS or CNS 7 Technical Status, and 
to modify the contents of Patch files. This function is 
not available for FCP 7. 


is used to delete a DNS and/or CNS 7 and/or FCP 7 
Technical Status. 


is used to list the DNS and/or CNS Technical Statuses 
already installed on a given Set, and the version 
number of the DIUF Factory installed on the system. 


is used for loading a new version of the DIUF Factory, 
only at the request of your Bull CSE. 


is used to create the SYS.DSATRC_<Ict-name>_x 
files. The FCP 7 trace files must be created if FCP 7 is 
being installed for the first time, or if a new LCT 
(Local Communication Controller) is being added to 
the configuration. 
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10.4 The ENTER_DIUF Command 


Purpose 
Provides access to all the DIUF functions. 


Any functions which modify the contents of the files concerned must be submitted 
under the project SYSADMIN with USER=SYSADMIN. 


Syntax 


{ENTER_DIUF | DIUF} 
{FUNCTION=function-name |COMMAND=immediate-command} 


[SET={P|P2|R}] [JOBIN=MS] ; 


Parameters 


FUNCTION names a DIUF function to be performed, with 
subsequent parameters being taken at the user's 
terminal; forbidden in batch mode, it is mutually 
exclusive with COMMAND. 


COMMAND specifies a string containing no more than one DIUF 
function followed by its parameters. 


SET designates the Set to be updated; by default, this is: 


— At first installation (DSA Domain not yet 
initialized): 


The P-Set, in a P2P- or PO-Configuration. 
The R-Set, in an RP-Configuration. 


— The running Set, in all other cases. 


JOBIN may occasionally be required for debugging purposes. 
When set to MS, it launches the DIUF functions below 
from library SYS.DSASLIB, not from the installation 
media: 


— INSTAL, for the installation option 


— LOADFACT, for the load factory option. 
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Initial Installation 


Your Bull CSE performs this procedure during the installation described in the 
chapter /nstallation Procedure. It allows the installation of one or several DNS 
and/or CNS 7 and/or FCP 7 Technical Statuses on the P-Set during its building. 


Procedure 


NOTE: 


The first five steps will often have been done already (when the P-Set was built 
in the factory from the P-MEDIA). 


Mount the media containing the DNS/CNS 7/FCP 7 Release to be installed. 


Proceed with installation on the P-Set, as follows, either: 


S: DIUF [SET=P] COMMAND='INSTAL TSVOL=tsmd:tsdvc, 
TSTYP={CNS|DNS|NCC}, DSAVOL=dsamd:dsadvc;'; 


or: 


S: DIUF [SET=P] FUNCTION=INSTAL; 


followed by introduction of the TSVOL, TSTYP and DSAVOL parameters on 
the next screen. 


tsmd and tsdvc are, respectively, the media name and device class of the 
media containing the DNS/CNS 7/FCP 7 Release to be installed. 


TSTYP is the DSA product to be installed: DNS, CNS or FCP 7. 


dsamd and dsadve are, respectively, the media name and device class of the 
volume on which the SYS.DSA* files are to be allocated. The DSAVOL 
parameter is given only at first installation of a DNS or CNS 7 Release. It 
must be given on every installation of an FCP 7 Release. The volume must be 
of FBO organization. 


INSTAL allocates the SYS.DSABLIB, SYS.DSASLIB, SYS.DSALMLIB, 
SYS.DSACONF, SYS.DSACORE, SYS.DSADUMP, SYS.DSACMD, and 
SYS.DSALOGI files on the P-Set at first installation. If an FCP 7 Release is 
installed, INSTAL also allocates the SYS.DSATRCIDT <fcp-ts> file on the 
P-Set. 


If an FCP 7 Release is to be installed, run the DIUF function 
BUILD_TRCNCC to allocate the SYS.DSATRC _<Ict-name>_x files on the 
P-Set. 


The BUILD_TRCNCC function is described later in this chapter. 
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4. If further DNS/CNS 7/FCP 7 Technical Statuses are to be installed, repeat 
Steps 1, 2 and 3, the requisite number of times. 


This is the same as for Steps 1, 2 and 3 above, except that DSAVOL must not 
be given when installing a DNS or CNS 7 Technical Status, since all the 
required SYS.DSA* files have already been allocated. However DSAVOL 
must always be specified when installing an FCP 7 Technical Status. 


5. Validate the P-Set and create the P2P or R-Configuration as described in the 
chapter /nstallation Procedure, using the GIUF functions VALIDP, BUILDP2, 
or INSTAL_RSET functions as appropriate. 


6. Reload the system from the P-Set. 


7. Perform Datanet and/or CNP7 SYSGEN, as appropriate, on the frontend 
processors affected by the Technical Status(es) installed in Steps 1, 2 and 4 
above. 


Refer to the appropriate System Generation Guide. 


Note that FCP 7 does not need system generation. 


NOTE: 
DNS or CNS 7 Patch files may be modified, if necessary, at the end of Step 3 
and Step 4, using the DIUF function PATCH: 


S: DIUF FUNCTION=PATCH SET=...; 
Or: 


S: DIUF COMMAND='PATCH ...' SET=...; 
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DOMAINS-MEDIA or TS-MEDIA 


DIUF FUNCTION = INSTAL 


VALIDP 


‘ 


During 
SYSGEN P-Set Installation 
BUILD_TRCNCC 
(FCP7 only) PUlEP re 
; on 
INSTAL_RSET 
R-Set 


Figure 10-1. Initial Installation of DNS/CNS 7/FCP 7 via the DIUF Facility 
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10.6 Add-on installation 


DNS and/or CNS 7 and/or FCP 7 is added to the user's existing configuration by 
adding to the system, as appropriate: 


e The corresponding MIs (Marketing Identifiers) 
e The required file Domain. 


If at least one of the DNS, CNS 7 or FCP 7 Releases already exists, then one or 
both of the other two can be installed simply by adding their MI(s). The file 
Domain does not need to be recreated. 


Adding an MI must be done before applying the "Updating Procedure for a New 
DNS or CNS 7 or FCP 7 Release", as explained below. The procedure for adding 
an MI is as follows: 


e Ina PO Configuration, by running the GIUF function ADD_MI on the P-Set. 


e Ina P2P Configuration, by running the GIUF function ADD_MI on the running 
Set and subsequently transfer the update to the non-modified Set with the GIUF 
function LEVEL _MI. 


e In an RP Configuration, by running the GIUF function ADD_MI on the P-Set 
and subsequently transfer the update to the R-Set with the GIUF function 
LEVEL MI. 


If neither DNS nor CNS 7 nor FCP 7 exist on the system, the procedure differs 
according to the type of configuration involved, PO, P2P or RP. 


10.6.1 PO-Configuration Add-On Procedure 
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NOTE: 
Installation is performed on the P-Set. 


1. Mount the media containing the DNS and/or CNS 7 and/or FCP 7 Release to 
be installed. 


2. Perform installation on the P-Set, as appropriate, with either: 


S: DIUF [SET=P] COMMAND='INSTAL TSVOL=tsmd:tsdvc, 
TSTYP={CNS|DNS|NCC}, DSAVOL=dsamd:dsadvc;'; 


or: 


S: DIUF [SET=P] FUNCTION=INSTAL; 


followed by the introduction of the TSVOL, TSTYP and DSAVOL parameters 
on the next screen. 
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tsmd and tsdvc, respectively, the media name and device class of the volume 
containing the DNS/CNS 7/FCP 7 Release to be installed. 


TSTYP is the DSA product to be installed: DNS, CNS or FCP 7. 


dsamd and dsadvc are, respectively, the media name and device class of the 
volume on which the SYS.DSA* files are to be allocated. The DSAVOL 
parameter is given only at first installation of a DNS or CNS 7 Release. It 
must be given on every installation of an FCP 7 Release. The volume must be 
of FBO organization. 


INSTAL allocates the SYS.DSABLIB, SYS.DSASLIB, SYS.DSALMLIB, 
SYS.DSACONF, SYS.DSACORE, SYS.DSADUMP, SYS.DSACMD, and 
SYS.DSALOGI files on the P-Set at first installation. If an FCP 7 Release is 
installed, INSTAL also allocates the SYS.DSATRCIDT <fcp-ts> file on the 
P-Set. 


3. Ifan FCP 7 Release is to be installed, run the DIUF function 
BUILD_TRCNCC to allocate the SYS.DSATRC_<Ict-name>_x files on the 
P-Set. 


The BUILD_TRCNCC function is described later in this chapter. 


4. If further DNS/CNS 7/FCP 7 Technical Statuses are to be installed, repeat 
Steps 1, 2 and 3, the requisite number of times. 


This is the same as for Steps 1, 2 and 3 above, except that DSAVOL must not 
be given when installing a DNS or CNS 7 Technical Status, since all the 
required SYS.DSA* files have already been allocated. However DSAVOL 
must always be specified when installing an FCP 7 Technical Status. 


5. Ifnew MIs are to be validated, run the GIUF function ADD _ MI, in order to 
validate the DSA system file Domain on the P-Set. 


6. Reload the system from the P-Set. 


If new MIs have been validated, the RESTORE option is mandatory, in order 
to implement the MIs just validated. 


If no MIs have been validated, the RESTORE option is not required. 


7. Perform Datanet and/or CNP7 SYSGEN, as appropriate, on the front-end 
processors affected by the Technical Status(es) installed in Steps 1, 2 and 4 
above. 


Refer to the appropriate System Generation Guide. 
Note that FCP 7 does not need system generation. 
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NOTE: 
DNS or CNS 7 Patch files may be modified, if necessary, at the end of Step 3 
and Step 4, using the DIUF function PATCH: 


Ss 


Or: 


Ss: 


D 


oO 


IUF COMMAND='PATCH ... 


DSA Installation and Updating Facility 


IUF FUNCTION=PATCH SET=...; 


SET=...; 


DOMAINS-MEDIA or TS-MEDIA 


DIUF FUNCTION = INSTAL 


BUILD_TRCNCC 


(FCP7 only) 
7" y 
ADD_MI | 
° y 
p-set * | SYSGEN 


Figure 10-2. 
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PO-Configuration Add-On Procedure 
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10.6.2 P2P-Configuration Add-On Procedure 


NOTE: 
Installation is started with the P-Set running. 


1. Mount the media containing the DNS and/or CNS 7 and/or FCP 7 Release to 
be installed. 


2. Perform the installation on the P-Set, as appropriate, with either: 


S: DIUF [SET=P] COMMAND='INSTAL TSVOL=tsmd:tsdvc, 
TSTYP={CNS|DNS|NCC}, DSAVOL=dsamd:dsadvc;'; 


or: 


S: DIUF [SET=P] FUNCTION=INSTAL; 


followed by introduction of the TSVOL, TSTYP and DSAVOL parameters on 
the next screen. 


tsmd and tsdvc are, respectively, the media name and device class of the 
volume containing the DNS/CNS 7/FCP 7 Release to be installed. 


TSTYP is the DSA product to be installed: DNS, CNS or FCP 7. 


dsamd and dsadve are, respectively, the media name and device class of the 
volume on which the loaded SYS.DSA* files are to be allocated. The 
DSAVOL parameter is given only at first installation of a DNS or CNS 7 
Release. It must be given on every installation of an FCP 7 Release. The 
volume must be of FBO organization. 


INSTAL allocates the SYS.DSABLIB, SYS.DSASLIB, SYS.DSALMLIB, 
SYS.DSACONF, SYS.DSACORE, SYS.DSADUMP, SYS.DSACMD, and 
SYS.DSALOGI files on the P-Set at first installation. If an FCP 7 Release is 
installed, INSTAL also allocates the SYS.DSATRCIDT_<fcp-ts> file on the 
P-Set. 


3. If further DNS/CNS 7/FCP 7 Technical Statuses are to be installed, repeat 
Steps | and 2 above as appropriate. 


This is the same as for Steps 1 and 2 above, except that DSAVOL must not be 
given when installing a DNS or CNS 7 Technical Status, since the loaded 
SYS.DSA* files have already been allocated. However DSAVOL must 
always be specified when installing an FCP 7 Technical Status. 
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4. The GIUF function BUILDP2 can be used to copy the P-Set to the P2-Set 
concemed. The corresponding TLRGEN options are: 


TLRGEN FILESET=DSA COMSET=INITIAL ; 


BUILDP2 is used: 


— to extend the DNS/CNS 7/FCP 7 Technical Status just installed 
(SYS.DSABLIB, SYS.DSASLIB, SYS.DSALMLIB, and possibly the 
SYS.DSATRCIDT_<fcp-ts> files), from the P-Set to the P2-Set 


— and to allocate the SYS.DSACONF, SYS.DSACORE, SYS.DSADUMP, 
SYS.DSACMD and SYS.DSALOGI files on the P2-Set. 


For the TLRGEN options, refer to Chapter 6. 


5. Ifan FCP 7 Release is to be installed, run the DIUF function 
BUILD_TRCNCC to allocate the SYS.DSATRC_<Ict-name>_x files on the 
(running) P-Set and then on the (non-running) P2-Set. 


The BUILD_TRCNCC function is described later in this chapter. 


If no new MIs need to be validated, jump to Step 7; otherwise proceed with 
Step 6. 


6. Ifnew MIs are to be validated, run the GIUF function ADD_MI on the 
running P-Set. 


Run the GIUF function LEVEL MI in order to validate the DSA file Domain 
on the (non-running) P2-Set. 


7. Reload the system from the P-Set. 


— Ifnew MIs have been validated, the RESTORE option is mandatory, in 
order to implement the MIs just validated. 
— Ifno MI has been validated, the RESTORE option is not required. 


8. Perform Datanet and/or CNP7 SYSGEN, as appropriate, on the front-end 
processors affected by the Technical Status(es) installed in Steps 1 to 3 above. 


Refer to the appropriate System Generation Guide. 
Note that FCP 7 does not need system generation. 


NOTE: 
DNS or CNS 7 Patch files may be modified, if necessary, at the end of Step 2 
and Step 3, using the DIUF function PATCH: 


S: DIUF FUNCTION=PATCH SET=...; 


Or: 


S: DIUF COMMAND='PATCH ...' SET=...; 
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ADD_MI Needed 


DOMAINS-MEDIA or TS-MEDIA 


DIUF FUNCTION = INSTAL 


’ 


> P-Set 


< ADD MI* 


<+— SYSGEN 
v 


BUILDP BUILD_TRCNCC BUILDP2 
FILESET=DSA (FCP7 only) FILESET=DSA 


* 


== 
| < SYSGEN 


P2-Set 


A 


LEVEL_MI 


It should be noted that, in fact, both ADD_MI and the subsequent LEVEL_Ml 
function may be launched either before or after execution of DIUF. 


Figure 10-3. P2P Configuration Add-On Procedure, using ADD_MI 
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No ADD_MI Needed 


DOMAINS-MEDIA or TS-MEDIA 


DIUF FUNCTION = INSTAL 


' 


P-Set <—! SYSGEN 
Po 
ees ae " BUILD_TRCNCC 
i. (FCP7 only) 
A a 
P2-Set  <——. SYSGEN 


Figure 10-4. P2P Configuration Add-On Procedure, Without ADD_MI 
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10.6.3. RP-Configuration Add-On Procedure 


NOTE: 
Installation is performed on the R-Set. 


1. Mount the media containing the DNS and/or CNS 7 and/or FCP 7 Release to 
be installed. 


2. Proceed with installation on the R-Set, as follows, either: 


S: DIUF [SET=R] COMMAND='INSTAL TSVOL=tsmd:tsdvc, 
TSTYP={CNS|DNS|NCC}, DSAVOL=dsamd:dsadvc;'; 


or: 


S: DIUF [SET=R] FUNCTION=INSTAL; 


followed by introduction of the TSVOL, TSTYP and DSAVOL parameters on 
the next screen. 


tsmd and tsdvc are, respectively, the media name and device class of the 
volume containing the DNS/CNS 7/FCP 7 Release to be installed. 


TSTYP is the DSA product to be installed: DNS, CNS or FCP 7. 


dsamd and dsadve are, respectively, the media name and device class of the 
volume on which the loaded SYS.DSA* files are to be allocated. The 
DSAVOL parameter is given only at first installation of a DNS or CNS 7 
Release. It must be given on every installation of an FCP 7 Release. The 
volume must be of FBO organization. 


INSTAL allocates the SYS.DSABLIB, SYS.DSALMLIB, and the 
SYS.DSASLIB files on the R-Set at first installation. If an FCP 7 Release is 
installed, INSTAL also allocates the SYS.DSATRCIDT <fcp-ts) file on the 
R-Set. 


3. If further DNS/CNS 7/FCP 7 Technical Statuses are to be installed, repeat 
Steps | and 2 above as appropriate. 


This is the same as for Steps | and 2 above, except that DSAVOL must not be 
given when installing a DNS or CNS 7 Technical Status, since the loaded 
SYS.DSA* files have already been allocated. However DSAVOL must 
always be specified when installing an FCP 7 Technical Status. 
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4. The GIUF function BUILDP must be run from the R-Set to the P-Set 
concemed. The corresponding TLRGEN options are: 


TLRGEN FILESET=DSA COMSET=INITIAL ; 


BUILDP is used: 


— to extend the DNS/CNS 7/FCP 7 Technical Status just installed 
(SYS.DSABLIB, SYS.DSASLIB, SYS.DSALMLIB, and possibly the 
SYS.DSATRCIDT_<fcp-ts> files), from the R-Set to the P-Set. 


— and to allocate the SYS.DSACONF, SYS.DSACORE, SYS.DSADUMP, 
SYS.DSACMD and SYS.DSALOGI files on the P-Set. 


For the TLRGEN options, refer to Chapter 6. 


5. Ifan FCP 7 Release is to be installed, run the DIUF function 
BUILD_TRCNCC to allocate the SYS.DSATRC_<Ict-name>_x files on the 
(running) R-Set and then on the (running or non-running) P-Set. 


The BUILD_TRCNCC function is described later in this chapter. 


If no new MIs need to be validated, jump to Step 7; otherwise proceed with 
Step 6. 


6. Ifnew MIs are to be validated, run the GIUF function ADD_MI on the non- 
running P-Set. 


Run the GIUF function LEVEL MI in order to validate the DSA file Domain 
on the R-Set. 


7. Reload the system from the P-Set or R-Set. 


— Ifnew MIs have been validated, the RESTORE option is mandatory, in 
order to implement the MIs just validated. 


— Ifno MI has been validated, the RESTORE option is not required. 


8. Perform Datanet and/or CNP7 SYSGEN, as appropriate, on the front-end 
processors affected by the Technical Status(es) installed in Steps 1 to 3 above. 


Refer to the appropriate System Generation Guide. 
Note that FCP 7 does not need system generation. 


NOTE: 
DNS or CNS 7 Patch files may be modified, if necessary, at the end of Step 2 
and Step 3, using the DIUF function PATCH. Either: 


S: DIUF FUNCTION=PATCH SET=...; 


Or: 


S: DIUF COMMAND='PATCH ...' SET=...; 
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DOMAINS-MEDIA or TS-MEDIA 


DIUF FUNCTION = INSTAL 


v 


R-Set 


BUILDP BUILD. TRCNCC 
LEVEL MI FILESET=FSA (FCP7 only) 


P-Set <«——| SYSGEN 


ADD_MI* 


* It should be noted that, in fact, both ADD_MI and the subsequent LEVEL_Ml 
function may be launched either before or after execution of DIUF. 


Figure 10-5. RP-Configuration Add-On Procedure 
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10.7 Updating 
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This operation may be performed on any one of the user's Sets (P, P2 or R), as 
appropriate to the requirements of his installation, and involves the installation of a 
new Technical Status which may be either: 


1. 


Anew DNS, CNS 7 or FCP 7 Release, or a new Technical Status without 
bringing forward any site Patch corrections. In this case, either the INSTAL 
function or the UPDATE function without the TSREF parameter may be used. 


An update to an already-installed Release. In this case there are two 
possibilities: 


— without bringing forward any site Patch corrections, the INSTAL function 
or the UPDATE function without the TSREF parameter may be used. 

— with bringing forward site specific Patch corrections, the UPDATE function 
with TSREF may be used. 


NOTES: 


1. 


An already-installed Technical Status cannot be re-installed with the 
UPDATE function. For this purpose use the INSTAL function. 


The function DELETE. _TS (described later in this chapter) must be used to 
delete the superseded version of DNS, CNS 7 or FCP 7, if the new version 
is to be processed by DIUF as the default option. 


10.7.1. Updating Procedure Without Bringing Forward Patches 


1. 
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Mount the media containing the DNS and/or CNS 7 and/or FCP 7 Release to 
be installed. 


Proceed with installation on the desired Set, with one of the following: 


- S: DIUF [SET={P|P2|R}] COMMAND='INSTAL TSVOL = 
tsmd:tsdvc, TSTYP={CNS|DNS|NCC};'; 


- S: DIUF [SET={P|P2|R}] FUNCTION=INSTAL; 


followed by introduction of the TSVOL parameter on the next screen. 


Or with one of the following: 


- S: DIUF [SET={P|P2|R}] COMMAND='UPDATE TSVOL = 
tsmd:tsdvc, TSTYP={CNS|DNS|NCC};'; 


- §S: DIUF [SET={P|P2|R}] FUNCTION=UPDATE; 


followed by the introduction of the TSVOL, or TSTYP, parameter (but not 
TSREF) on the following screens. 
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tsmd and tsdvc are, respectively, the media name and device class of the 
media containing the DNS/CNS 7/FCP 7 Technical Status to be installed. 


TSTYP is the DSA product to be installed: DNS, CNS or FCP 7. The DSA 
product FCP 7 is related to FCP 7. 


When using the INSTAL function for DNS or CNS 7 installation, DSAVOL 
must not be given since this is not the first installation. For FCP 7 
installation, however, DSAVOL must always be given. 


3. At first installation of an FCP 7 Release, run the DIUF function 
BUILD_TRCNCC to allocate the SYS.DSATRC_<Ict-name>_x files on the 
P-Set and P2-Set. 


The BUILD_TRCNCC function is described later in this chapter. 


4. Jn P2P- and RP-Configurations, reload the system from the target Set, 
provided that this is neither the running Set nor the R-Set. 


PO-Configuration should skip this step, and go directly to Step 6. 


5. Perform SYSGEN in order to generate DNS or CNS 7, as appropriate, on the 
running target Set, unless this is the R-Set. 


Refer to the appropriate System Generation Guide. This is the final Step to be 
performed on PO-Configuration. 


Note that FCP 7 does not need system generation. 


6. In order to extend the Technical Status just applied in P2P- and 
RP-Configurations, run the GIUF function LEVEL with the DSA 
parameter on the other Set of the configuration. 


7. Reload the system from the other Set of the configuration, unless this is either 
the running Set or the R-Set. 


8. Perform SYSGEN in order to generate DNS or CNS 7, as appropriate, on the 
other Set of the configuration (unless it is the R-Set), for the frontend 
processors affected by the Technical Status installed in Steps 1 and 2 above. 


Refer to the appropriate System Generation Guide. 
Note that FCP 7 does not need system generation. 


NOTE: 
DNS or CNS 7 Patch files may be modified, if necessary, at the end of Step 2, 
using the DIUF function PATCH: 


S: DIUF FUNCTION=PATCH SET=...; 
or: 


S: DIUF COMMAND='PATCH ...' SET=...; 
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10.7.2 Updating Procedure With Patches Brought Forward 
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1. 


Mount the media containing the DNS and/or CNS 7 and/or FCP 7 Technical 
Status to be installed. 


Proceed with installation on the desired Set, as follows, either: 


S: DIUF [SET={P|P2|R}] COMMAND='UPDATE 
TSVOL=tsmd:tsdvc, TSREF=tsref, 
TSTYP={CNS|DNS|NCC},  [TS=xxxx], 
[REPLACE={0|1}], [DELPAT=segfile], 
[PRTFILE=seqfile] ;'; 


or: 


S: DIUF [SET={P|P2|R}] FUNCTION=UPDATE; 


followed by introduction of the TSVOL, TSTYP, TS, TSREF, REPLACE, 
DELPAT and PRTFILE parameters on the screens that follow. 


tsmd and tsdvc are, respectively, the media name and device class of the 
media containing the DNS/CNS 7/FCP 7 Technical Status to be installed. 


TSTYP is the DSA product to be installed: DNS, CNS or FCP 7. 


DELPAT is used if Updating Procedure has aborted because of corrections 
which could not be brought forward, to designate a sequential file (or subfile) 
containing DELETE requests for corrections not to be brought forward to the 
new Technical Status; for further details, see under REQUEST SYNTAX later 
in this chapter. 


TS identifies the 4-digit number of the Technical Status to be installed. 


PRTFILE introduces a sequential file (or subfile) to contain the Patch 
Processor report; SYS.OUT is the default value. 


TSREF identifies the 4-digit number of the Technical Status from which 
site-specific Patches are to be conserved with the new Technical Status being 
installed. 


REPLACE=0 will preserve the referenced Technical Status. 
REPLACE=! will result in the Technical Status designated by TSREF being 
deleted. 


At first installation of an FCP 7 Release, run the DIUF function 
BUILD _TRCNCC to allocate the SYS.DSATRC <Ict-name> x files 
on the P-Set (RP, PO and P2P-Configurations) and then on the P2-Set 
(P2P-Configuration). 


The BUILD_TRCNCC function is described later in this chapter. 
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4. Jn P2P- and RP-Configurations, reload the system from the target Set, 
provided that this is neither the running Set nor the R-Set. 


PO-Configuration should not perform this step, but skip to Step 6. 


5. Perform SYSGEN in order to generate DNS or CNS 7, as appropriate, on the 
running target Set, unless this is the R-Set. 


Refer to the appropriate System Generation Guide. This is the final Step to be 
performed on PO-Configurations. 


Note that FCP 7 does not need system generation. 


6. In order to extend the Technical Status just applied in P2P- and 
RP-Configurations, run the GIUF function LEVEL with the DSA parameter 
on the other Set of the configuration. 


7. Reload the system from the other Set of the configuration, unless this is either 
the running Set or the R-Set. 


8. Perform SYSGEN in order to generate DNS or CNS 7, as appropriate, on the 
other Set of the configuration, unless this is the R-Set, in an 
RP-Configuration. 


Refer to the appropriate System Generation Guide. 
Note that FCP 7 does not need system generation. 


NOTE: 
DNS or CNS 7 Patch files may be modified, if necessary, at the end of Step 2, 
using the DIUF function PATCH. Either: 


S: DIUF FUNCTION=PATCH SET=...; 


or: 


S: DIUF COMMAND='PATCH ...' SET=...; 
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DOMAINS-MEDIA or TS-MEDIA | 


DIUF FUNCTION = {INSTAL| UPDATE } 


PO 
Configurations ' : 
{P|P2|R*}-Set | eter 


| 
| 
| 
| 
| 
| 
| 
| 
v Vv J 


_ BUILD_TRCNCC 
LEVEL - = Do) | (FCP7 only) 


f a 
{P|P2|R*}-Set sf SYSGEN | 


* No SYSGEN is performed on an R-Set. 


Figure 10-6. Updating Procedure in the DIUF Facility 
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10.8 
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Patching 


This function allows the user to apply Emergency Corrections (EC) which may 
consist of any of: 


e Patches 


e Patch deletions 


e The reactivation of Patches which have been cancelled 


For a detailed description of the corrections supported, refer to "Patch Processor" 
later in this chapter. 


NOTE: 


Patching is not applicable to FCP 7 


Patching Procedure 


1. 
2. 


Mount the media containing the Patch(es) to be applied. 
Launch the DIUF Patch session with either: 
S: DIUF [SET={P P2 |R} ] COMMAND='PATCH TS=ts PATFILE= 
patfile [PRTFILE=prtfile];'; 
or: 
S: DIUF [SET={P|P2|R}] FUNCTION=PATCH; 
Followed by introduction of the TS, PATFILE and PRTFILE parameters on 
the next screen. 


In all cases, the default value for SET is the running Set. In a P2P- 
Configuration, the updated Set may be either the P- or the P2-Set. In an 
RP-Configuration, the running Set may be either the R- or the P-Set (although 
usually the latter). The file containing the corrections may be: 


lib..mb for the member of a resident or cataloged library 
member 

lib..mb:md:dvc for an uncataloged non-resident library member 

efn for a RESIDENT or cataloged sequential file 

efn:md:dve for an uncataloged non-resident sequential file 

TN for user console in asynchronous mode (for the 


command language, refer to "PATCH PROCESSOR" 
later in this chapter). 
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3. In P2P- and RP-Configurations, reload the system from the target Set, 
provided that this is neither the running Set nor the R-Set. 


PO-Configurations should not execute this step, but skip directly to step 4, 
below. 


4. Perform Datanet and/or CNP7 SYSGEN, as appropriate, on the running target 
Set, unless this is the R-Set. 


Refer to the appropriate System Generation Guide. This is the final Step to be 
performed on PO-Configurations. 


5. In order to extend the Emergency Corrections just applied in P2P- and 
RP-Configurations, run the GIUF function LEVEL with the DSA parameter 
on the other Set of the configuration. 


6. Reload the system from the other Set of the configuration, unless this is the 
R-Set, in an RP-Configuration. 


7. Perform Datanet and/or CNP7 SYSGEN, as appropriate, on the other Set of 
the configuration, unless this is the R-Set, in an RP-Configuration. 


Refer to the appropriate System Generation Guide. 


EC-MEDIA 
! DIUF FUNCTION = PATCH 
PO- | 
Configurations 
| {P|P2|R*}-Set | eroGEN | 
y 


LEVEL DOM = DSA 


’ 


{P|P2|R*}-Set = SYSGEN | 


* No SYSGEN is performed on an R-Set. 


Figure 10-7. Patching Procedure in the DIUF Facility 
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10.9 The DELETE_TS Function 


This function enables the user to delete a DNS/CNS 7/FCP 7 Technical Status that 
is of no further use. 


Deletion Procedure 


1. Launch the DELETE_TS session, with either: 
S: DIUF [SET ={P | P2 |R}] COMMAND='DELETE_TS TS=ts;'; 


or: 


S: DIUF [SET={P|P2|R}] FUNCTION=DELETE_TS; 


followed by introduction of the TS parameter on the next screen. 


The default value for SET is the running Set. In a P2P-Configuration, SET 
may be P or P2; in an RP-Configuration, SET may be R or P. Note that, in a 
PO-Configuration, this is the only step to be executed. 


2. In P2P- and RP-Configurations, delete the Technical Status from the 
installation's other Set, by repeating Step | above for that Set. 


DIUF FUNCTION = DELETE_TS 
PO- | 
Configurations 
{P|P2|R} - Set 
v 


DIUF FUNCTION = DELETE_TS 


{P|P2|R} - Set 


Figure 10-8. Patching Procedure in the DIUF Facility 
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10.10 Consulting 
This allows the user to list all the DNS/CNS 7/FCP 7 Technical Statuses installed 
on a given Set, and the Version Number of the DIUF Factory installed on that Set. 


Consulting Procedure 


Launch the LIST session with: 


S: DIUF FUNCTION=LIST [SET={P|P2|R}]; 


SET is by default the running Set. Ina 
P2P-Configuration, the Set may be P or P2; in an 
RP-Configuration, the Set may be R or P. 
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10.11 The LOAD_FACTORY Function 


This function enables the user to load a new version of the DIUF Factory from an 
installation media, but only to be undertaken at the request of your Bull CSE. 


Load Factory Procedure 


1. 
2. 
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Mount the media containing the new DIUF Factory. 
Launch the Load Factory session with either: 


S: DIUF [SET={P|P2|R}] COMMAND= 'LOADFACT TSVOL= 
tsmd:tsdvc;'; 


or: 


S: DIUF FUNCTION=LOADFACT; 


followed by introduction of the TSVOL parameter on the next screen. 


tsmd and tsdvc are, respectively, the media name and the device class of the 
media containing the DIUF Factory to be installed. 


This is the final step, for PO-Configurations. 


In P2P- and RP-Configurations, the new DIUF Factory may be extended to 
the installation's other Set, in either of the two following ways: 


— Running the GIUF function LEVEL with the DOM=DSA parameter, 
against the other Set. 


— Launching a LOADFACT session on the other Set, in the same way as in 
Step 2 above. 
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DIUF FUNCTION = LOADFACT 
PO- | 
Configurations ; 
! — {P|P2|R}- Set | 
eS tien ee v ES Oe Le ID I I LE eI a eI a eID eT SD EE ee Oe Ge ee 
— {P|P2|R} - Set. 
i DIUF = FUNCTION = LOADFACT 
LEVEL DOM=DSA i 
i | {P|P2|R} - Set | 
{P|P2|R} - Set 


Figure 10-9. Load Factory Procedure in the DIUF Facility 
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10.12 Patch Processor 


Patch file management is performed using the Patch Processor H_DIUF_MNPTF. 


Consultation and modification of the Patch files must always be via the DIUF 
function PATCH. There are five kinds of request: 


e Pi requests are used to enter a Patch into a Patch file. 
e Direquests are used to invalidate Patches from a Patch file. 
e Ri requests are used to revalidate formerly deleted Patches in a Patch file. 


e LS requests are used to list information about a given Known Problem Number 
(KPN) stored in a Patch file. 


e WR requests are used to print the contents of Patches stored in a Patch file. 
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Request Syntax 


Pi, Di AND Ri REQUESTS 


0 0 0 1 1 2 2 3 3.3 8 
1 3 6 1 5 2 6 2 6 9 0 
* xi ccuu KPN kkkkkk SER sssss REV w cc ... c 


AA i 
— Comment 
Patch Revision Number 


SER Number 
Known Problem Number 
TS Name 
Patch File impacted: 
'— Request Type: - 0 for PatchO 

- P for Patch - 1 for Patch1 


- D for Delete - 2 for Patch2 
- R for Recover 


LS AND WR REQUESTS 
0 0 0 1 1 2 8 
1 3 6 1 5 2 0 


xy ccuu KPN kkkkkk cc ... C 


A 
| i Comment 


Known Problem Number 
TS Name 


Request Type: 
- LS for List 
- WR for Write 
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Table 10-1. | Request Actions According to the State of the KPN in the CLC 


R 
: State of KPN in Patch Files 
Uu 
e Wrong Source Rev< _ Rev = Rev > 
gs | Absent Patch Corre- iNet Delet- Rete Delet- en ie Delet- 
t File cted ed ed ed 
RK Source ae * * RK RK 
p OK Wrong Corr'n er OK Al- Patch Newer Newer 
Patch Patch Delet- ready Reins- | Version | Version 
File Cannot ed Active tated Found Found 
Apply 
‘in nee Source x x 5 Rk . RK 
n- rong corr'n - - ewer ewer 
D known Patch cannot OK ready OK ready Version | Version 
KPN File be De- Deleted Deleted Found | Found 
leted 
Un- Ww Source Al- Al- Newer | Newer 
R known Dato corr'n ready OK ready OK Version | Version 
KPN File Lost? Active Active Found | Found + 
Un- OK 
LS known 
PN 
Un- 
WR] known OK 
PN 
This Table represents a Patch history of the installation kept by the system. 
KEY 
KPN=Known Problem Number. 
CLC=Cumulative List of Corrections. 
+ One or more newer versions have been found. A previous version (never deleted 
physically, only logically) is reactivated, with the result that all more recent 
versions are physically deleted (i.e., definitively). 
< Indicates a revision older than that being applied. 
> Indicates a revision more recent than that being applied. 
? Indicates that the Source Correction cannot be recovered. 
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10.13. The BUILD_TRCNCC Function 


This function enables you to allocate a set of n SYS.DSATRC <lIct-name>_x on 
the P-Set, P2-Set or R-Set specified. The Ict-name is the name of the Local 
Communication Controller related to FCP 7 (whose traces will be reported in these 
files), and x=1 through n. 


This function must be executed at the first installation of an FCP 7 Release, or ifa 
new LCT is added to the configuration. 


Building Procedure for SYS.DSATRC _<Ict-name>_x Files 


1. Run the BUILD_TRCNCC function with either: 


S: DIUF [SET={P|P2|R}] COMMAND='BUILD_TRCNCC LCT=lct-name, 
VOLUME=dsamd:dsadvc, NUMBER=n, SIZE=size ;' ; 


or 


S: DIUF [SET={P|P2|R}] FUNCTION=BUILD_TRCNCC ; 


followed by introduction of the LCT, VOLUME, NUMBER, and SIZE 
parameters on the next screen. 


SET is by default the running Set. In a P2P-Configuration, the Set may be P 
or P2; in an RP-Configuration, the Set may be R or P. Note that, in a 
PO-Configuration, this is the only step to be executed. 


Ict-name identifies the LCT whose traces will be reported in the associated 
SYS.DSATRC_<Ict-name>_x files. 


dsamd and dsadve are, respectively, the media name and device class of the 
volume on which SYS.DSATRC_<Ict-name>_x are to be allocated. 


nis the number of SYS.DSATRC_<Ict-name>_x files to be allocated, where 2 
<=n<=9. For example, if n=2, then two files are allocated: 
SYS.DSATRC <Ict-name>_1 and SYS.DSATRC <Ict-name>_2. 


SIZE is the combined size of all the SYS.DSATRC_<Ict-name>_x files. SIZE 
is in blocks. 


2. In RP and P2P-Configurations, run the BUILD_TRCNCC function on the 
other Set, by repeating Step 1 for that Set. 
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DIUF FUNCTION = BUILD_TRCNCC 


A A 
PO- 
Configurations 
P-Set 
y 
RP- or P2P- 
Configurations 
! {R|P2}- Set 
y 


DIUF FUNCTION = BUILD_TRCNCC 
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Figure 10-10. Building Procedure for SYS.DSATRC_<Ict-name>_x files 
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11. GCOS 7 Service Facilities (GSF) 


11.1 Introduction 


This facility is used to install and maintain all the components of the mandatory 
GSF (GCOS 7 Service Facilities) Domain on the7 P-Set, P2-Set, or R-Set, as 
appropriate. 


The GSF tools (RIDE, ASR7, DY NDUMP, TELECONTROL7, etc.), are needed to 
maintain a system either on site or through Remote Maintenance Access. These 
tools are located in the system files which belong to the GSF Domain and are 
cataloged in the SYS.CATALOG file, namely: 


SYS.GSF.BINLIB 
SYS.GSF.LMLIB 
SYS.GSF.SLLIB 
SYS.GSF.SMLIB 
SYS.GSF.UFAS. 


These GSF tools, use of which is restricted to the Bull CSE, may be accessed 
using the GSF function USAGE. 


GSF installation may take place in two distinct sets of circumstances: 


1. During initial GCOS 7 software Release installation as described in the 
chapter /nstallation Procedure. 


2. Onan existing system, during the life of a GCOS 7 software Release. 


From a GSF Release Media supplied by the your Bull CSE, installation is 
performed on any of the user's Sets (P-, P2-, or R-Set, as appropriate to the 
Configuration type). The non-updated Sets may subsequently be modified 
with the new version by using the GIUF function LEVEL (DOMAIN=GSF). 
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11.2 GSF Tools 


The IOF user may access the GSF Facility by using the GCL command 
ENTER _GSF (alias GSF), which provides the following facilities: 


INSTAL is used to install the GSF Domain initially. This is 
done from the GSF Release Media, which can be 
magnetic tape or cartridge. 


UPDATE is used to install a new version of GSF on an 
already-installed GSF Domain, from the GSF Release 
Media which can be magnetic tape or cartridge. 


USAGE is used by Bull personnel to access the GSF tools, in 
order to maintain the system. 


CAUTION: 
The Installation and Updating procedures consist of installing, or reinstalling 
the GSF system file Domain each time a new GSF Release becomes available. 
Consequently, a GSF Release Media may be considered as being equivalent to a 
GSF Technical Status Media. 


11.3 GSF Release Media 


A GSF Release Tape or Cartridge always has a MEDIA name in the form: 
GSFxyy 


where: 
x stands for the GSF Release Number 
yy stands for the GSF Technical Status 


for example: 
GSF122 
identifies GSF Release 1 and Technical Status 22. 


When updating the GSF Domain, the GSF components are sometimes located on a 
multi-Domain Release media. If this is the case, your Bull CSE will inform you 
accordingly. 
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The ENTER_GSF Command 


Purpose 


e Provides access to the GSF functions INSTAL, UPDATE and USAGE. 
e All functions must be submitted under the SYSADMIN Project. 


Syntax 


{ENTER_GSF|GSF} {FUNCTION={ INSTAL |UPDATE|USAGE} 
| COMMAND=immediate-command} 


[SET={P|P2|R}] ; 


Parameters 

FUNCTION names a GSF function to be performed, with 
subsequent parameters being taken at the user's 
terminal; forbidden in batch mode, it is mutually 
exclusive with COMMAND. 

COMMAND specifies a string containing no more than one GSF 
function followed by its parameters. 

SET designates the Set to be updated; by default, this is: 


At first installation (GSF Domain not yet initialized): 
e The P-Set, in a PO or P2P Configuration. 

e The R-Set, in an RP Configuration 

e The running Set, in all other cases. 


Note that the USAGE function does not require the COMMAND and SET 
parameters. 
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Updating 


Before Beginning 


Before applying a new GSF Technical Status, ensure that the SYS.GSF.BINLIB is 
not in use otherwise the following message will appear: 


"WAITING FOR FILE SYS.GSF.BINLIB" 


This operation may be performed on any one of the user's Sets, as appropriate to 
the requirements of the installation, and involves the installation of a new GSF 
Release Media on an already-installed GSF Domain. 


The site's other Sets will be updated using the GIUF function LEVEL, but for the 
GSF Domain only; i.e., LEVEL ... DOM=GSF. In updating operations, the 
following GSF function UPDATE must be used. 


GSF Technical Status Media 


GSF FUNCTION=UPDATE 


_{P|P2|R} - SET 


LEVEL DOM=GSF 


' 


{P|P2|R} - SET 


Figure 11-1. Updating the GSF Domain 
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Updating Procedure 


1. 


Mount the GSF Technical Status Media containing the GSF Release to be 
installed. 


Proceed with installation on the desired Set, with either: 


S: GSF [SET={P|P2|R}] COMMAND='UPDATE TSVOL=tsmd:tsdvc 
GSFVOL=gsfmd:gsfdvc; '; 


or: 


S: GSF [SET={P|P2|R}] FUNCTION=UPDATE; 


followed by introduction of the TSVOL and GSFVOL parameters on the 
following screen. 


where: 

TSVOL identifies the GSF Release Media's name and device 
class. 

GSFVOL identifies the Set on which the GSF system files are to 


be allocated, as appropriate. Any resident disk in the 
Set may be used. 
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12. Maintenance and Recovery Procedures 


NOTE: 
The RESTORE function, which is carried out under SIP in UTIL mode on non- 
XTA systems and is described in this chapter, has been replaced by the 
RESTORE facility which is run from the Bootstrap GCOS disk (B-DISK) 


12.1 General Considerations 


This chapter deals with the installation and maintenance requirements of fixed-disk 
systems, especially with regard to the placement of system files. Performance 
aspects are not treated, but certain general considerations should be kept in mind 
when planning disk allotment: 


e Disk space management 
e Recovery procedures 


e P2-Set (or R-Set) disk and Updating procedures. 


12.1.1 Disk Space Management 


All the data required for normal operation should be kept on line at all times, since 
immediate disk reconfiguration is not possible (i.e., no MOUNT processing). This 
implies careful disk-space management by both system managers and users; on the 
other hand, it permits unattended/remote operations and better disk-drive 
performance. 
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12.1.2 Recovery Procedures for Data Volumes 


There are no such procedures specific to fixed-disk systems; but, to ensure 
reasonably rapid recovery from a possible disk failure, you should provide enough 
free space in the storage subsystem to allow user files to be stored elsewhere as 
well as to allow the application of "after images" before restarting operations. 


To simplify disk space management, you should identify one disk drive as a 
potential spare; the disk may either be cleared or contain data that is already saved 
and not required during normal production operations. This drive may be used to 
restore (with the GCL procedure RESTORE FILE, or RESTORE _FILESET) all 
the files previously located on the failed drive. 


12.1.3 P2-Set/R-Set Disk and Updating Procedures 


The P2P-Configuration allows the use of a second production Set as the reference 
for IUF updating operations. This second Set, referred to as the P2-Set, ensures 
both: 


e Full support of parallel updating 
e Easy restart in the event of P-Set failure. 


In an RP-Configuration, the R-Set is used both for rollback and for ensuring 
consistency in Updating procedures. The R-Set is required during maintenance 
procedures (except for EC patching with the GIUF functions PATCH_*), which 
means that it must be restored from tape/cartridge if is not kept on line, with a 
consequent increase in maintenance operation time. This point is discussed in 
more detail below. 


In multi-system configurations, Slave Systems may thus dispense completely with 
their own R-Set, when they are updated via the GIUF functions SAVE_SET + 
RESTORE _SET once Technical Status application has been performed on the 
Master System. 


In this latter case, it is highly desirable that a SAVE_DISK of a P-Set be made, to 
enable restore operations using SIP, in the event of disk failure. 


12.1.4 Tape, Cartridge, and Cassette Subsystems 
Tape, cartridge, and cassette subsystems are used to make a backup of the system. 


Save and Restore times vary widely depending on the DPS 7000 platform and the 
type of backup medium. 
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12.1.5 MS/FSA Disk Subsystem 


1s IMPORTANT: 

Even in a protected environment where securized RAID-1 and RAID-S disks 
are used, it is nonetheless important to have a P2P configuration or at least an 
RP configuration. A securized system cannot guarantee that files will not be 
damaged or even destroyed. 


Three types of disk configuration may be defined: large, medium and small. 


12.1.5.1 Large Configuration 


In a "large" configuration, the P2-Set is kept on line, to reduce software updating 
time. Since this Set is saved after any change, it may also be used as a potential 
spare drive in the event of a user disk or system disk failure. 


In a very large configuration, the P2-Set is permanently on line and at the same 
time there is a permanently identified spare disk drive, to reduce software updating 
time. 


Since this Set is saved after any change, it may also be used as a potential spare 
drive in the event of a user disk or system disk failure. 


12.1.5.2 Medium Configuration 


This will usually be an RP-Configuration. A P2P-Configuration is feasible, 
although the full benefits of this would not be realized, partly because of the 
increased overhead of saving a P2-Set to and restoring a P2-Set from tape or 
cartridge. 


Whatever the total number of drives in the system, a "medium" configuration 
means a disk subsystem containing only P-Set disks and user disks, without any 
spare drives and with a single R-Set disk image on tape/cartridge, to be restored to 
disk whenever needed. 


12.1.5.3 Small Configuration 


This will usually be a PO-Configuration, where there is neither P2-Set nor R-Set as 
a backup in case of P-Set failure. 


As mentioned earlier, it is highly desirable that a SAVE_DISK of the P-Set be 
made, to enable restore operations using SIP, in the event of disk failure. 
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12.2 


12.2.1 


12.2.2 


12-4 


Updating 


In P2P- and RP-Configurations, most GIUF procedures need the P2-Set or the 
R-Set on line, to operate correctly. 


Large Configuration 


The P2-Set or the R-Set should normally be on line. 


If the drive supporting the P2-Set or the R-Set has been used for some other 
purpose (e.g., recovery, or work), the System Administrator must restore the Set to 
the spare drive. This operation may be performed in parallel with normal 
operations, if a tape/cartridge drive is available for the purpose. 


If the P2-Set or R-Set is updated during the procedure, it must of course be saved 
to tape/cartridge again. 


If the P2-Set feature is used, the system may continue its production activity during 
the update. 


Medium Configuration 


The R-Set is available only on tape/cartridge, and the disk to receive it normally 
contains user files. The sequence of operations is as follows: 


1. Save user files to tape/cartridge. 

VOLPREP the disk. 

Restore the R-Set to disk with the GCL procedure RESTORE_DISK. 
Perform the IUF functions. 

If the R-Set has been modified by 4, resave it to tape/cartridge. 
VOLPREP the disk. 


Restore the user files from tape/cartridge to disk. 


DOs a TON. ON a ae 


Restart the applications. 


If the user files in 1) and 7) are accessed by the applications in 8), the above steps 
should be performed separately from normal operations. 


In the event of a problem with the P-Set, the contents of a user disk will be 
overwritten by the restored P2-Set or R-Set; this is because SIP does not have disk 
test routines as powerful as those provided by GCOS 7. 
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12.2.3. Small Configuration 
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As mentioned elsewhere in this manual, a PO-Configuration is the least expensive, 
but also the least secure, type of configuration available. 


When a site has installed a PO-Configuration, recovery from P-Set failure may be 
met by restore operations under SIP; this is explained at the end of the chapter 
Installation Procedure. 


Any site that uses a P2P-Configuration (or RP-Configuration) should consider 
itself, for the purposes of this chapter, as a "medium" configuration and use the 
appropriate procedure above. 
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12.3. Slave Updating 


When a site is updated using the GIUF functions SAVE_SET + RESTORE SET, 
the P2-Set/R-Set need not be on line. 


12.3.1. Large Configuration 


The P2-Set should normally be on line. The RESTORE SET function updates this 
disk during normal production operation, and the user may then switch to this new 
system. 


12.3.2 Small or Medium Configuration 


There is no P2-Set (on line). The RESTORE_SET function updates the running 
system, which should be idle in order to avoid conflicts on system files. 


A single execution of the GCL procedure SAVE_DISK on the P-Set ensures 
sufficient backup when using the SIP function RESTORE in UTIL mode. 
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A. System File Descriptions 


A.1 Introduction 


In the following pages, certain files are described by a PREALLOC or LIBALLOC 
JCL statement, as appropriate, even if the TAILOR processor in fact calls a 
FILDUPLI-OUTALC JCL statement to create it. Constant or parametered 
characteristics are given in connection with the visibility of the file through the 
TAILOR language. 


NOTES: 


1. Throughout this Appendix, "any FSA resident disk" means either the 
system disk or any disk declared as resident. 


2. The disk DEVCLASSes allowed are MS/FSA only for the system and 
resident disks. 


System files for all Domains that are delivered already loaded are on 
FSA volumes. System files that are created on the user site may be on 
the system disk, or on FSA resident/non-resident volumes, as indicated 
for each file. Wherever possible, all files making up the P-Set should be 
grouped together on the system disk, since this greatly facilitates 
management and recovery. 


3. "CATALOG =n", or" CAT =n", specifies the rank "n" of the catalog to be 
used, as defined in the currently-active ATTACH statement. 


4. Sizes of files in the Firmware Domain depend on the model of DPS 7000 
and on the BSR release. The examples in Appendix A give average sizes. 


5. Sizes of files in Domains other than Firmware depend on the evolution of 
GCOS 7 according to the Technical Status applied. The examples in 
Appendix A give average sizes. 
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The GCL equivalents of JCL statements referred to here are as follows: 
JCL GCL 


PREALLOC BUILD _FILE 
CREATE MT FILE 
MODIFY FILE SPACE 


LIBALLOC BUILD_LIBRARY 


FILDUPLI COPY_FILE 
COPY_FILESET 


1(2)3 IMPORTANT: 
1. 


User sub-files must never be placed in system libraries, as they would be 
lost when updating or returning to a previous Technical Status. The only 
exceptions to this rule are the SITE.HELP file, the SYS.DSACOMF file. 


In these two cases only, it is recommended that suitable user objects be 
stored in the files concerned where they will be preserved in the event of a 
system update. 


The PREALLOC/LIBALLOC JCL statements used to describe some of 
the files are given for information purposes only. They must not be used 
without the agreement of Bull, and then only in exceptional circumstances. 


The files of the FW and OLTD domains contain parameters that are 
required by the system and they are referenced by a physical address. For 
this reason, they must NEVER be handled other than by using the tools 
provided for this purpose (FGF, TDF). Any attempt to move, delete, copy, 
or relocate these files, including moving them to another volume, can 
cause incidents that may even be catastrophic. 


Volumes containing FW files must never be restored using REORG unless 
all ad hoc FGF commands are executed after the restore. You are 
recommended to confide these tasks to qualified Bull CSEs. 
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Table A-1. List of System Files 


File Name 


Allocatable on 
Mirror Disk 


SITE.CATALOG 


SITE.CMS _* 


YES 


SITE.HALOCK 


SITE.HELP 


SITE.IN 


SITE.MIRLOG 


SITE.STARTUP 


SYS.BKST 


SYS.BKST{i] 


SYS.BOOT 


SYS.C.INCLUDE 


SYS.CLC 


SYS.CATALOG 


SYS.DSA* 


SYS.DSALOG[i] 


SYS.ERLOG 


SYS.FW.* 


SYS.FW.MSP (see Note) 


SYS.FW.WSP(see Note) 


SYS.GPL.MACLIB 


SYS.GSF.* 


SYS.HBINLIB 


SYS.HBINLIB2 


SYS.HCULIB 


SYS.HELP 


SYS.HLMLIB 


SYS.HLMLIB2 


SYS.HSLLIB 


SYS.HSLLIB2 


SYS.HUB (see Note) 


SYS.HUB7 (see Note) 


SYS.HUBG 


SYS.IN 


SYS.IUF 


System File Descriptions 
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Allocatable on 
Mirror Disk 
SYS.JADIR YES 
SYS.JAS* YES 
SYS.JRNAL YES 
SYS.JTRVAL[i] 
SYS.KNODET 
SYS.LIB[i] 
SYS.LOGC 
SYS.OUT 
SYS.PVMF[i] 
SYS.QM* 
SYS.SITE.* 
SYS.SPDUMP YES 
SYS.SPOOL|[i] YES 
SYS.SWLOG YES 
SYS.SYSDUMP 
SYS.SYSTEM 
SYS.SYSTEM2 
SYS.TVMF{i] 
SYS.URCINIT 


File Name 


NOTE: 
SYS.HUB7 is loaded by the BSR P2 and mandatory for the 
DPS 7000/TAxxx/TAxxxC, and DPS7000/MTx2 and up. 


SYS.FW.MSP, SYS.FW.WSP, SYS.HUB and SYS.HUB7 do not exist on XTA 
systems 
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A.2 The SITE.CATALOG File 


File Name 


SITE.CATALOG 


Domain 


GCOS 


Function 


This file contains descriptions of the following items: 


e User, project, billing, site 
e Private catalogs 
e Cataloged files and volumes. 


Organization 
Undefined 


Size 
SIZE (NBOBJ) 1940 


Location 


This is a mandatory file that may be located on any FSA resident disk; it contains at 
least log-on data. If preallocated by TAILOR, it may be located on SYSVOL, 
RSDVOL, or RSDVOL1. SITE.CATALOG may be copied from any disk to any 
other disk by the IUF function COPY_SITEFILES. 


EXAMPLE OF ALLOCATION: 


CATBUILD SITE.CATALOG, DVC=MS/FSA, MD=md, SYSTEM, NBOBJ=1940; 


Q 


TAILOR Commands: 
CATFL, SYSVOL, RSDVOL, RSDVOL1 
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A.3 The SITE.CMS_CSD File 


File Name 


SITE.CMS_CSD 


Domain 


GCOS 


Function 


Contains complex generation result tables that describe the configuration of 
GCOS 7. 


Organization 


UFAS Indexed 


Location 


This file may be located on any FSA shared disk. If created by TAILOR, it may be 
located on RSDVOL, RSDVOL1, NRDVOL or NRDVOLI. 


TAILOR Commands: 


CMS, SYSVOL, RSDVOL, RSDVOL1, NRDVOL, NRDVOL1 


GIUF Command: 


BUILD_CMS 
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A.4 The SITE.CMS_CDD_NAMEi File 


File Name 


SITE.CMS_CDD_namei 


namei corresponds to the network name of a coupled system, where i=1 for one of 
the systems and i=2 for the other system. 


Domain 


GCOS 


Function 

This file is used for managing coupled systems. It contains the initialization of the 
dynamic state of the component corresponding to "namei". 

Organization 

UFAS Indexed 

Size 


SIZE (CI) 100 


Location 


This file may be located on any FSA shared disk. If created by TAILOR, it may be 
located on SYSVOL, RSDVOL, RSDVOL1, NRDVOL or NRDVOLI. 


TAILOR Commands: 


CMS, SYSVOL, RSDVOL, RSDVOL1, NRDVOL, NRDVOL1 


GIUF Command: 


BUILD_CMS 
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A.5 The SITE.CMS_DS_NAME1_NAME2 File 


File Name 


SITE.CMS_ DS namel1_name2 


Domain 


GCOS 


Function 


This file is used for managing coupled systems. It contains the initialization of the 
structures for mutual surveillance between the members "namel" and "name2". 


Organization 


NONE 


Size 


SIZE (BLOCK) 3) 


Location 


This file may be located on any FSA shared disk. If created by TAILOR, it may be 
located on SYSVOL, RSDVOL, RSDVOL1, NRDVOL or NRDVOLI. 


TAILOR Commands: 


CMS, SYSVOL, RSDVOL, RSDVOL1, NRDVOL, NRDVOL1 


GIUF Command: 


BUILD_CMS 
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A.6 The SITE.HALOCK File 


File Name 


SITE .HALOCK 


Domain 


GCOS 


Function 


Used with TDS-HA (TDS High Availability), this file provides the synchronization 
and serialization services required within a coupled systems configuration. 


Organization 


NONE 


Size 


SIZE (BLOCK) 4 


Location 


This file may be located on any FSA disk. If created by TAILOR, it may be 
located on SYSVOL, RSDVOL, RSDVOL1, NRDVOL or NRDVOLI. 


TAILOR Commands: 


HALOCK, SYSVOL, RSDVOL, RSDVOL1, NRDVOL, NRDVOL1 


GIUF Command: 


BUILD_HALOCK 
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A.7 


A-10 


The SITE.HELP File 


File Name 


SITE .HELP 


Domain 


GCOS 


Function 


This file contains site-specific help texts related to GCL commands, and standard 
help texts in the official local language. 


Organization 


Library 


Size 


SIZE (BLOCK) 170 


Location 


This is a mandatory file that may be located on any FSA disk. If preallocated by 
TAILOR, it may be located on SYSVOL, RSDVOL, or RSDVOLI. 


EXAMPLE OF ALLOCATION: 


LIBALLOC SL, (SITE.HELP, UNIT=BLOCK, DVC=MS/FSA, 
J=md, SIZE=(170, 170), 


FILESTAT=CAT, CAT=n, CATNOW, EXPDATE=365), 
DIRSIZE=14, MAXSIZE=1500; 

Q) 

TAILOR Commands: 


SITHELP, SYSVOL, RSDVOL, RSDVOL1 
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A.8 The SITE.IN File 


47 A2 23US 


File Name 


SITE.IN 


Domain 


GCOS 


Function 


This file is used to store input data defined by the JCL statement $DATA. 


Organization 


Queued Linked 


Size 
SIZE (BLOCK) 170 


Location 


This is an optional file that may be located on any FSA disk, and must be cataloged 
if created. If preallocated by TAILOR, it may be located on SYSVOL, RSDVOL, 
or RSDVOL1 and must be cataloged accordingly. 


EXAMPLE OF ALLOCATION: 


PREALLOC SITE.IN, UNIT=BLOCK, 

DVC=MS/FSA, GLOBAL=(MD=md, SIZE=170), 
LINKQD= (TYPE=NONE, BLKSIZE=4070, RECSIZE=264, 
LTRKSZ=1, DIRSIZE=3, RECFORM=VB, NDLREC), 
CATNOW, FILESTAT=CAT, CAT=n; 


Q 


TAILOR Commands: 


SITIN, SYSVOL, RSDVOL, RSDVOL1 
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A.9 The SITE.MIRLOG File (if applicable) 


File Name 


16) 


Domain 


GCOS 


Function 


ITE.MIRLOG 


This file keeps a trace of internal activities on mirrored disks. 


Organization 


NONE 


Size 


SIZE (BLOCK) 40 


Location 


This file may be located on any FSA non-MIRROR volume. If created by 
TAILOR, it may be located on SYSVOL, RSDVOL, RSDVOL1, NRDVOL or 
NRDVOLI. 


TAILOR Commands: 


MIRLOG, 


SYSVOL, RSDVOL, RSI 


GIUF Command: 


BUILD_M] 


[RLOG 
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DVOL1, NRI 


DVOL, NRDVOL1 
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A.10 The SITE.STARTUP File 


File Name 


SITE. STARTUP 


Domain 


GCOS 


Function 

This file contains site-specific JCL and GCL sequences for automatic insertion at 
the beginning of batch and IOF jobs. 

Organization 

Library 

Size 


SIZE (BLOCK) 170 


Location 


This is a mandatory file that may be located on any FSA disk, and must be 
cataloged. If preallocated by TAILOR, it may be located on SYSVOL, RSDVOL, 
or RSDVOL1. The file may be copied from any disk to any other disk, using the 
IUF function COPY_SITEFILES. 
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EXAMPLE OF ALLOCATION: 


CATALOG SITE.STARTUP, SHARE=DIR, DUALSHR=ONEWRITE, 
CATALOG=n ; 
LIBALLOC SL, (SITE.STARTUP, UNIT=BLOCK, MD=md, 


DVC=MS/FSA, SIZE=(170,170), 
FILESTAT=CAT, CAT=n, CATNOW), 
DIRSIZE=8, MAXSIZE=850; 


TAILOR Commands: 


STUP, SYSVOL, RSDVOL, RSDVOL1 


A-14 47 A2 23US 


System File Descriptions 


A.11. THE SYS.BKST File 


File Name 


SYS.BKST 


Domain 


GCOS 


Function 
This file provides system backing store, to contain: 


e The crash area 
e The non-releasable area loaded at restore time 


e A temporary paging backing store (which may also be located in SYS.BKSTi). 


Organization 


Non-standard FBO. 


Size 
SIZE (BLOCK) 15980 


The size of SYS.BKST is independent of memory size. However, it does depend 
on the number of active jobs. The larger the memory size, the more active jobs 
there will be. 


When built on-site, the default SIZE is 15980 blocks, irrespective of the amount of 
memory installed. The maximum possible size of a BKST is 65535 blocks. 
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Location 


This is a mandatory file, to be located on the system disk. The file may have up to 
2 extents but must be mono-volume. 


If this file is allocated with two extents, its extent #1 must be of a minimum size: 
32 MB in order to be able to contain the crash area. 


The SYS.BKST file cannot be allocated on mirror disks. 
It may be allocated by either: 


e TAILOR 
e The IUF function BUILD_BKST. 


TAILOR Commands: 


BKST, SYSVOL 


GIUF Command: 


BUILD_BKST 
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A.12 The SYS.BKST[Ii] File(s) 


File Name 


SYS.BKST [i] (where i = from 1 to 15) 


Domain 


GCOS 


Function 


These files provide paging backing store for temporary use, intended to contain, in 
virtual memory format, the temporary segments of all types belonging to job steps. 


The size of BKST(i) files is related to the number of jobs running and to the 
applications themselves. It must also take account of the available memory that 
determines the number of segment SWAPIN/SWAPOUTs. 


Organization 


Non-standard FBO. 


Size 
SIZE (BLOCK) 4250 
Location 


These are optional files that may be located on any FSA resident or non-resident 
disk, and are preallocated by the user with the IUF function BUILD_BKST. 


The SYS.BKSTi files may be allocated on SYSVOL, RSDVOL, RSDVOL1, 
NRDVOL, or NRDVOL1. They may have multiple extents but must be mono- 
volume. 
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The SYS.BKSTi files cannot be allocated on mirror disks. 


NOTE: 
The sum of the extents of all the SYS.BKSTi files must be < 16. To improve 
processing performance the user is advised to allocate several SYS.BKST1 files, 
each with a few extents, and on different volumes. 


TAILOR Commands: 


BKST1, SYSVOL, RSDVOL, RSDVOL1, NRDVOL, NRDVOL1 


GIUF Command: 


BUILD_BKST 
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Backing Store Classification 


Table A-2. Backing Store Classification 


SYS. SYS. SYS. SYS. SYS. 
BKST BKSTi TVFMi PVMFi_ LIBi 


SYSTEM J =0 - Initial Segments X 
TYPE =0 - Segment Created X X 
Dynamically 
Step with - Initial Segment X X 
Non-preinitialized - Segment Created X 
LM Dynamically 
- Temporary VMF xX 
Step with - Initial Segment X 
Preinitialized LM - Segment Created Xx Xx 
Dynamically 
- Temporary VMF xX 
Step with - Initial Segment X 
REPEAT Option - Segment Created X X 
Dynamically 
- Temporary VMF xX 
- Checkpoints X 
Permanent Virtual Xx 
Memory Files 
Sharable Modules X 
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A.13. The SYS.BOOT File 


File Name 


SYS. BOOT 


Domain 


GCOS 
Function 


This file is used when starting a system session. 


Organization 


Non-standard 


Size 


SIZE (BLOCK) 650 


Location 


This is a mandatory file that must be located on the system disk. If preallocated by 
TAILOR, it is located on SYSVOL, and must be cataloged accordingly. 


TAILOR Commands: 


Not visible to TAILOR language. 
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A.14 The SYS.C.INCLUDE File 


File Name 


SYS.C. INCLUDE 


Domain 


GCOS 


Function 


This file contains the standard C files and C source header files to be included in C 
language user programs. 


Organization 


Library 


Sizes 


SIZE (BLOCK) 750 
INCRSIZE (BLOCK) 170 
MAXSIZE (BLOCK) 2000 


Location 


This is a mandatory file that may be located on any FSA disk (preferably the 
system disk). If copied by TAILOR, it is located on SYSVOL. 


i IMPORTANT: 
3 ; : 
| This file must not contain any user sub-files. 


47 A2 23US A-21 


GCOS 7 System Installation Configuration and Updating Guide 


EXAMPLE OF ALLOCATION: 


PREALLOC SYS.C.INCLUDE, DVC=MS/FSA, UNIT=BLOCK, 
GLOBAL=(MD=md, SIZE=750), 

LINKQD= (NONE= (BLKSTZE=4070, RECSIZE=264, 

RECFORM=VB, TYPE=SL, NDLREC, COMPACT, DIRSIZE=8, 

LTRKSZ=2, MAXSIZE=2000)), INCRSIZE=170, 

FILSTAT=CAT, CATNOW, CAT=n; 


TAILOR Commands: 


Not visible to TAILOR language. 
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A.15 The SYS.CATALOG File 


File Name 


SYS . CATALOG 


Domain 


GCOS 


Function 


This file is the system catalog, used for cataloging system files. 


Organization 


Non-standard. 


SIZE (NBOBJ) 1940 


Location 


This is a mandatory file that must be located on the system disk. 


EXAMPLE OF ALLOCATION: 


CATBUILD SYS.CATALOG, DVC=MS/FSA, MD=md, NBOBJ=1940; 


Q 


TAILOR Commands: 
Not visible to TAILOR language. 
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A.16 The SYS.CLC File 


File Name 


SYS.CLC 


Domain 


GCOS 


Function 


Used for cartridge library management. 


Organization 
Linked Queued 
Size 


SIZE (BLOCK) 510 


Location 


This is an optional file that may be located on any FSA disk. If created by 
TAILOR, it may be located on SYSVOL, RSDVOL, RSDVOL1, NRDVOL, or 
NRDVOLI. 

TAILOR Commands: 


CLC, SYSVOL, RSDVOL, RSDVOL1, NRDVOL, NRDVOL1 


GIUF Command: 


BUILD_CLC 
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A.17 The SYS.DSABLIB File 


File Name 


SYS .DSABLIB 


Domain 


DSA 


Function 


This file contains all the binary input necessary to CNS7 administration and the 
FCP 7 image. 


Organization 


Library 
Size 
SIZE (BLOCK) 4500 


Location 


This is an optional file that may be located on any FSA disk. If required, it is 
preallocated and copied by TAILOR on SYSVOL, RSDVOL, or RSDVOLI. 


EXAMPLE OF ALLOCATION: 


LIBALLOC BIN, (SYS.DSABLIB, UNIT=BLOCK, MD=md, DVC=MS/FSA, 
SIZE=(4500, 1700), 
CATNOW, FILESTAT=CAT, CAT=n), 
MEMBERS=6000, MAXSIZE=15000; 


TAILOR Commands: 


DSAFILES, SYSVOL, RSDVOL, RSDVOL1 
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A.18 The SYS.DSACMD File 


File Name 


SYS .DSACMD 


Domain 


DSA 


Function 


This file contains certain telecoms-specific commands sent to the system from 
other DSA systems in the network. A separate subfile is created to contain each 
such command together with the response(s) it receives. 


Organization 


Library 


Size 


SIZE (BLOCK) 510 


Location 


This is an optional file that may be located on any FSA disk. If allocated by the 
TAILOR functions BUILDP and BUILDP2, it may be located on SYSVOL, 
RSDVOL, or RSDVOLI. 
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EXAMPLE OF ALLOCATION: 


LIBALLOC BIN (SYS.DSACMD, UNIT=BLOCK, MD=md, DVC=MS/FSA, 
SIZE=(510, 680), EXPDATE=365, CATNOW, 

FILESTAT=CAT, CAT=n), 
MEMBERS=2000, MAXSIZE=3300; 


TAILOR Commands: 


DSAFILES, SYSVOL, RSDVOL, RSDVOL1 
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A.19 


A-28 


The SYS.DSACONF File 


File Name 


SYS . DSACONF 


Domain 


DSA 


Function 


This file contains user input relative to Network Administration. 


Organization 


Library 


Size 


SIZE (BLOCK) 340 


Location 


This is an optional file that may be located on any FSA disk. If preallocated and 
copied by TAILOR, it may be located on SYSVOL, RSDVOL, or RSDVOL1. 


EXAMPLE OF ALLOCATION: 


LIBALLOC SL, (SYS.DSACONF, UNIT=BLOCK, MD=md, DVC=MS/FSA, 
SIZE=(340, 340), 
CATNOW, FILESTAT=CAT, CAT=n), 
COMPACT, MEMBERS=2000, MAXSIZE=6000; 


TAILOR Commands: 


DSAFILES, SYSVOL, RSDVOL, RSDVOL1 
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A.20 The SYS.DSACORE File 
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File Name 


SYS . DSACORE 


Domain 


DSA 


Function 


This file contains core images of the CNS7 systems. Its contents are created by 
CNS7 generation to be used as input to CNS7 system loading. 


Organization 


Library 
Size 
SIZE (BLOCK) 340 


Location 


This is an optional file that may be located on any FSA disk. If required, it is 
preallocated by TAILOR on SYSVOL, RSDVOL, or RSDVOLI. 


EXAMPLE OF ALLOCATION: 


LIBALLOC BIN, (SYS.DSACORE, UNIT=BLOCK, MD=md, DVC=MS/FSA, 
SIZE=(340, 680), 
CATNOW, FILESTAT=CAT, CAT=n), 
MAXSIZE=7200, DIRSIZE=7; 


TAILOR Commands: 


DSAFILES, SYSVOL, RSDVOL, RSDVOL1 
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A.21. The SYS.DSADUMP File 


File Name 


SYS . DSADUMP 


Domain 


DSA 


Function 


This is a "post-mortem" dump file that is used for output when a DNS, CNS7 or 
FCP 7 system aborts. 


Organization 


Library 


Size 


SIZE (BLOCK) 7200 


Note, for FCP 7 a minimum size of 7200 blocks is required. 


Location 


This is an optional file that may be located on any FSA disk. If required, it is 
preallocated by TAILOR on SYSVOL, RSDVOL, or RSDVOLI. 
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EXAMPLE OF ALLOCATION: 


LIBALLOC BIN, (SYS.DSADUMP, UNIT=BLOCK, MD=md, DVC=MS/FSA, 
SIZE=(7200, 7200) 
CATNOW, FILESTAT=CAT, CAT=n), 
MAXSIZE=72000, DIRSIZE=7; 


TAILOR Commands: 


DSAFILES, SYSVOL, RSDVOL, RSDVOL1 
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A.22 


A-32 


The SYS.DSALMLIB File 


File Name 


SYS .DSALMLIB 


Domain 


DSA 


Function 


This file contains the Load Modules H DIUF MNPTF and H_DIUF GCL used by 
the DIUF Factory. 


Organization 


Library 
Size 
SIZE (BLOCK) 170 


Location 


This is an optional file that may be located on any FSA disk. If required, it is 
preallocated and copied by TAILOR on SYSVOL, RSDVOL, or RSDVOLI. 


EXAMPLE OF ALLOCATION: 


LIBALLOC LM, (SYS.DSALMLIB, UNIT=BLOCK, MD=md, DVC=MS/FSA, 
SIZE=(170, 85), 
CATNOW, FILESTAT=CAT, CAT=n), 
MEMBERS=100; 


TAILOR Commands: 


DSAFILES, SYSVOL, RSDVOL, RSDVOL1 
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A.23. The SYS.DSALOG1 File 
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File Name 


SYS .DSALOG1 


Domain 


DSA 


Function 


This file contains AEP (Administrative Exchange Protocol) records sent by the 
NADs (Network ADministrators) of other DSA systems in the network. 


Organization 


UFAS Relative 


Size 


SIZE (BLOCK) 680 


Location 


This is an optional file that may be located on any FSA disk. If required, it is 
preallocated by TAILOR on SYSVOL, RSDVOL, or RSDVOLI. 
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EXAMPLE OF ALLOCATION: 


As SYS.DSALOGI1 must be cataloged with specific sharability attributes, its 


creation requires two steps: 


CATALOG SYS.DSALOG1 SHARE=ONEWRIT 


EF CATALOG=n; 


PREALLOC SYS.DSALOG1, UNIT=BLOCK, 
GLOBAL=(MD=md, SIZE=680), 


UFAS= (RELATIVE= (CISIZE=4096, RECSIZI 


RECFORM=VB, NBULBL=1) ), 
FILESTAT=CAT, CAT=n; 


Q 


TAILOR Commands: 


DSALOG, SYSVOL, RSDVOL, RSDVOL1 
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DVC=MS/FSA, 


OG 


=200, 
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A.24 The SYS.DSALOG[i] Files 
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File Name 


SYS .DSALOGi (where i = from 2 to 10) 


Domain 


DSA 


Function 


These files contain AEP (Administrative Exchange Protocol) records sent by NADs 
(Network ADministrators) from other DSA systems in the network. 


Organization 


UFAS Relative 


Sizes 


Chosen by user. 


Location 


These are optional files created by the user that may be located on any disk. 
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EXAMPLE OF ALLOCATION: 


As SYS.DSALOGi must be cataloged with specific sharability attributes, file 


creation requires the two follow 


ing steps: 


CATALOG SYS.DSALOGi SHARE=ONEWRITE CATALOG=n; 


PREALLOC SYS.DSALOGi, UNIT=BLOCK, DVC=MS/FSA, 
GLOBAL= (MD=md, SIZE=size), 


UFAS= (RELATIVE= (CISIZE=4096, RECSIZI 


RECFORM=VB, NBULI 


OG 


=200, 
BL=1)), 


FILESTAT=CAT, CAT=n, CATNOW; 


TAILOR Commands: 


Not within the scope of TAILOR. 
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A.25 The SYS.DSASLIB File 


File Name 


SYS .DSASLIB 


Domain 


DSA 


Function 


This file contains all the source input necessary for DNS and/or CNS7 and/or FCP 
7 administration, and the DIUF factory. 


Organization 


Library 
Size 
SIZE (BLOCK) 850 


Location 


This is an optional file that may be located on any FSA resident disk. If required, it 
is preallocated and copied by TAILOR on SYSVOL, RSDVOL, or RSDVOLI. 


EXAMPLE OF ALLOCATION: 


LIBALLOC SL, (SYS.DSASLIB, UNIT=BLOCK, MD=md, DVC=MS/FSA 
SIZE=(850, 340), 
CATNOW, FILESTAT=CAT, CAT=n), 
MAXSIZE=15000, MEMBERS=1000; 


TAILOR Commands: 


DSAFILES, SYSVOL, RSDVOL, RSDVOL1 


47 A2 23US A-37 


GCOS 7 System Installation Configuration and Updating Guide 


A.26 The SYS.DSATRC_<LCT-NAME> [i] Files (Specific to FCP 7) 


File Name 

SYS .DSATRC_xxxx_1 (where xxxx = the LCT name, and 
Be 2S 1 O29) 

Domain 

DSA 

Function 


These files contain FCP 7 traces of the associated LCT (Local Communication 
Controller). 


Organization 


UFAS Sequential 


Sizes 


Chosen by user. 


Location 
These files are mandatory if the FCP 7 product is installed. 


They are created by the user with the IUF function BUILD_TRCNCC as described 
in the chapter DSA Installation and Updating Facility, and may be allocated on any 
disk. 
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EXAMPLE OF ALLOCATION: 


As aSYS.DSATRC_xxxx_i file must be cataloged with specific sharability 
attributes, its creation requires two steps: 


CATALOG SYS.DSATRC_EA91_3 SHARE=ONEWRITE CATALOG=n ; 


PREALLOC SYS.DSATRC_FA91_3, UNIT=BLOCK, DVC=MS/FSA, 
GLOBAL=(MD=md, SIZE=size), 
UFAS= (SEQ= (CISIZE=25088, RECSIZE =4104, 
RECFORM=F, NBULBL=0) ) , 
FILESTAT=CAT, CAT=n, CATNOW; 


TAILOR Commands: 
Not within the scope of TAILOR. 


DIUF Command: 
BUILD_TRCNCC with the following parameters: 
LCT=Ict-name, VOLUME=md:dvc, NUMBER=n, SIZE=size. 
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A.27. The SYS.DSATRCIDT_NXYY File 
(Specific to an FCP 7 Technical Status) 


File Names 


SYS .DSATRCIDT_<fcp-ts> (<fcp-ts>=Nxyy for not XTA systems and 
<fcp-ts> = Dxyy for XTA systems 


Domain 


DSA 


Function 


This file contains input data necessary for the management of FCP 7 traces of a 
particular FCP 7 Technical Status. 


Organization 


UFAS Indexed 


Size 


variable 


Location 
This file is mandatory if the associated FCP 7 Technical Status is installed. 


This file is automatically restored on the volume containing the SYS.DSASLIB 
file, during the installation of its associated FCP 7 Technical Status. The Technical 
Status is installed using the DIUF functions INSTAL and UPDATE, the IUF 
functions LEVEL and RESTORE _SET, the IUF installation jobs INSTAL_ALL, 
INSTAL _PSET and INSTAL_RSET, and by TAILOR. 


This file must be allocated on any resident or non-resident FSA volume. 
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EXAMPLE OF ALLOCATION: 


The SYS.DSATRCIDT <fcp-ts> file must be cataloged with the 
SHARE=ONEWRITE attribute and so its creation requires two steps: 


CATALOG SYS.DSATRCIDT_<fcp-ts> SHARE=ONEWRITE CATALOG=n; 


PREALLOC SYS.DSATRCIDT_<fcp-ts>, UNIT=BLOCK, DVC=MS/FSA, 
GLOBAL=(MD=md, SIZE=340), INCRSIZE=170, 
UFAS= (INDEXED= (CISIZE=1356, RECSIZE=256, 
RECFORM=V, KEYLOC=1, KEYSIZE=4) ) 
FILESTAT=CAT, CAT=n, CATNOW; 


DIUF, GIUF, and TAILOR Commands: 
Not within the scope of TAILOR, DIUF, or GIUF. 
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A.28 The SYS.ERLOG File 


File Name 


SYS . ERLOG 


Domain 


GCOS 


Function 


This file contains a trace of hardware and system errors that occur during a system 
session. 


Organization 


Non-standard. 


Size 


SIZE (BLOCK) 85 


Location 


This is a mandatory file that may be located on any disk. Its recommended 
location is on the system disk, if the other logging files are not located there. If 
preallocated by TAILOR, it may be located on SYSVOL, RSDVOL, or 
RSDVOLI. 


A-42 47 A2 23US 


47 A2 23US 


System File Descriptions 


EXAMPLE OF ALLOCATION: 


As SYS.ERLOG must be cataloged with specific sharability attributes, its creation 
requires two steps: 


CATALOG SYS.ERLOG SHARE=ONEWRITE CATALOG=n; 


PREALLOC SYS.ERLOG, DVC=MS/FSA, INCRSIZE=170, 
GLOBAL=(MD=md, SIZE=85), 
UNIT=BLOCK, NONE=(BLKSIZE=8192) , 
FILESTAT=CAT, CAT=n, CATNOW; 


TAILOR Commands: 


ERLOG, SYSVOL, RSDVOL, RSDVOL1 
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A.29. The SYS.FW.BINLIB File 


File Name 


SYS.FW.BINLIB 


Domain 


FW 


Function 


This file contains binary firmware objects. 


Organization 


Library 


Sizes 


SIZE (BLOCK) 14000 
INCRSIZE (BLOCK) 10000 


Location 


This file may be located on any FSA resident disk. All SYS.FW.* queued linked 
(library) files must be located on the same volume. 
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A.30 The SYS.FW.CCULIB File (not applicable for XTA systems) 


File Name 


SYS .FW.CCULIB 


Domain 


FW 


Function 


This file contains binary firmware objects. 


Organization 


Library 


Sizes 


SIZE (BLOCK) 250 
INCRSIZE (BLOCK) 5000 


Location 


This file may be located on any FSA resident disk. All SYS.FW.* queued linked 
(library) files must be located on the same volume. 
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A.31 The SYS.FW.GENLIB File (not applicable for XTA systems) 


File Name 


SYS .FW.GENLIB 


Domain 


FW 


Function 


This file contains configuration-dependent firmware files produced by the 
FIRMGEN function. 


Organization 


Library 


Sizes 


File sizes are model dependent. 


SIZE (BLOCK) 550 
INCRSIZE (BLOCK) 5000 


Location 


This file may be located on any FSA resident disk. All SYS.FW.* queued linked 
(library) files must be located on the same volume. 
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A.32 The SYS.FW.LMLIB File 


File Name 


SYS.FW.LMLIB 


Domain 


FW 


Function 


This file contains firmware generation and updating Load Modules. 


Organization 


Library 


Sizes 


SIZE (BLOCK) 2700 
INCRSIZE (BLOCK) 4100 


Location 


This file may be located on any FSA resident disk. All SYS.FW.* queued linked 
(library) files must be located on the same volume. 
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A.33 
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The SYS.FW.MSP (not applicable for XTA systems) 


File Name 


SYS .FW.MSP 


Domain 


FW 


Function 


This file contains the MSP firmware controller. It is created and managed by 
BLOAD only. 


Organization 


Non-standard. 


Sizes 

SIZE (BLOCK) 153 
DBLK 1400 
Location 

On each system disk. 
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A.34 The SYS.FW.NFTLIB File (not applicable for XTA Systems) 


File Name 


SYS.FW.NFTLIB 


Domain 


FW 


Function 


This file is used to store Central Subsystem non-functional tests. 


Organization 


Binary Library 


Sizes 


SIZE (BLOCK) 4000 
INCRSIZE (BLOCK) 5000 


Location 


This file may be located on any FSA resident disk. All SYS.FW.* queued linked 
(library) files must be located on the same volume. 
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A.35 The SYS.FW.PATCH File (not applicable for XTA Systems) 


File Name 


SYS.FW. PATCH 


Domain 


FW 


Function 


This file is used to store firmware EC and OPT patches. 


Organization 


Library 


Sizes 


SIZE (BLOCK) 125 
INCRSIZE (BLOCK) 375 


Location 


This file may be located on any FSA resident disk. All SYS.FW.* queued linked 
(library) files must be located on the same volume. 
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A.36 The SYS.FW.PRT File 


File Name 


SYS.FW. PRT 


Domain 


FW 


Function 


This file contains output produced by FGF functions. 


Organization 

Library 

Sizes 

SIZE (BLOCK) 500 
INCRSIZE (BLOCK) 9700 
Location 


This file may be located on any FSA resident disk. All SYS.FW.* queued linked 
(library) files must be located on the same volume. 


47 A2 23US A-51 


GCOS 7 System Installation Configuration and Updating Guide 


A.37 The SYS.FW.SLLIB File 


File Name 


SYS.FW.SLLIB 


Domain 


FW 


Function 


This file contains JCL and SL data used for firmware generation. 


Organization 

Library 

Sizes 

SIZE (BLOCK) 1000 
INCRSIZE (BLOCK) 5000 
Location 


This file may be located on any FSA resident disk. All SYS.FW.* queued linked 
(library) files must be located on the same volume. 
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A.38 The SYS.FW.WSP (not applicable for XTA Systems) 


File Name 


SYS .FW.WSP 


Domain 


FW 


Function 


This file contains the firmware controller (WSP-A, WSP-R or WSP depending on 
the type of disk subsystem). It is created and managed by BLOAD only. 


Organization 


Non-standard. 


Sizes 


SIZE (BLOCK) 153 
DBLK 1400 


Location 


On the system disk. 
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A.39 


A-54 


The SYS.GPL.MACLIB File 


File Name 


SYS.GPL.MACLIB 


Domain 


GCOS 


Function 


This file contains macro definitions used in connection with the GPL language. 


Organization 


Library 


Size 


SIZE (BLOCK) 510 


Location 


This mandatory file may be located on any FSA disk. If copied by TAILOR, this 
file is located on SYSVOL. 


EXAMPLE OF ALLOCATION: 


PREALLOC SYS.GPL.MACLIB, UNIT=BLOCK, DVC=MS/FSA, 
GLOBAL=(MD=md, SIZE=510), 
LINKQD= (NONE= (BLKSIZE=4070, RECSIZE =1024, 
TYPE=BIN, LTRKSZ=1, NDLREC,DIRSIZE=9, 
RECFORM=VB) ), INCRSIZE=170, 

CATNOW, FILESTAT=CAT, CAT=n; 


Q 


TAILOR Commands: 
Transparent to TAILOR language. 
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A.40 The SYS.GSF.BINLIB File 


By) 
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File Name 


SYS.GSF.BINLIB 


Domain 


GSF 


Function 


This file contains binary objects for Service components. 


Organization 


Library 


Sizes 


SIZE (BLOCK) 170 
INCRSIZE (BLOCK) 170 


Location 


This is a mandatory file that may be located on any FSA resident disk. If copied by 
TAILOR, it is located on SYSVOL. 


IMPORTANT: 
This file must under no circumstances contain any user sub-files. 


EXAMPLE OF ALLOCATION: 


LIBALLOC BIN (SYS.GSF.BINLIB, UNIT=BLOCK, MD=md, DVC=MS/FSA, 
SIZE=(170, 170), EXPDATE=365, FILESTAT=CAT, CATNOW, 
CAT=n), MEMBERS=1000; 


TAILOR Commands: 


GSFGEN, SYSVOL, RSDVOL, RSDVOL1. 
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A.41. The SYS.GSF.LMLIB File 


File Name 


SYS.GSF.LMLIB 


Domain 


GSF 


Function 


This file contains Load Modules for Service components. 


Organization 


Library 


Sizes 


SIZE (BLOCK) 170 
INCRSIZE (BLOCK) 170 


Location 


This is a mandatory file that may be located on any FSA resident disk. If copied by 
TAILOR, it is located on SYSVOL. 


1(2) IMPORTANT: 
leases This file must under no circumstances contain any user sub-files. 
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EXAMPLE OF ALLOCATION: 


PREALLOC SYS.GSF.LMLIB, DVC=MS/FSA, UNIT=BLOCK, 
GLOBAL=(MD=md, SIZE=170), 

LINKQD=(TYPE=LM, BLKSIZE=7168, RECSIZE=1024, 

RECFORM=FB, DIRSIZE=7, LTRKSIZE =1, MAXSIZE=10625, 

NDLREC), INCRSIZE=170, FILESTAT=CAT, CATNOW, CAT=n; 


TAILOR Commands: 


GSFGEN, SYSVOL, RSDVOL, RSDVOL1. 
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A.42 The SYS.GSF.SLLIB File 


A-58 


“N 


File Name 


SYS.GSF.SLLIB 


Domain 


GSF 


Function 


This file contains source members for Service components as well as for GSF 
Facilities. 


Organization 


Library 


Sizes 


SIZE (BLOCK) 170 
INCRSIZE (BLOCK) 170 


Location 


This is a mandatory file that may be located on any FSA resident disk. If copied by 
TAILOR, it is located on SYSVOL. 


IMPORTANT: 
This file must under no circumstances contain any user sub-files. 
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EXAMPLE OF ALLOCATION: 


LIBALLOC SL (SYS.GSF.SLLIB, UNIT=BLOCK, MD=md, DVC=MS/FSA, 
SIZE=(170, 170), EXPDATE=365, 
FILESTAT=CAT, CATNOW, CAT=n), MEMBERS=3000; 


TAILOR Commands: 


GSFGEN, SYSVOL, RSDVOL, RSDVOL1. 
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A.43. The SYS.GSF.SMLIB File 


File Name 


SYS.GSF.SMLIB 


Domain 


GSF 


Function 


This file contains Sharable Modules and Linked Units used by Service 
components. 


Organization 


Library 


Sizes 


SIZE (BLOCK) 


INCRSIZE 


Location 


(BLOCK) 


170 


170 


This is a mandatory file that may be located on any FSA resident disk. If copied by 
TAILOR, it is located on SYSVOL. 


IMPORTANT: 
ers This file must under no circumstances contain any user sub-files. 
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EXAMPLE OF ALLOCATION: 


LIBALLOC SM (SYS.GSF.SMLIB, UNIT=BLOCK, MD=md, DVC=MS/FSA, 
SIZE=(170, 170), EXPDATE=365, 
FILESTAT=CAT, CATNOW, CAT=n), MEMBERS=100; 


TAILOR Commands: 


GSFGEN, SYSVOL, RSDVOL, RSDVOL1. 
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A.44 The SYS.GSF.UFAS File 


File Name 


SYS.GSF.UFAS 


Domain 


GSF 
Function 


This file contains items for use by Service components. 


Organization 


UFAS Indexed 


Size 


SIZE (BLOCK) 114 


Location 


This is a mandatory file that may be located on any FSA resident disk. If copied by 
TAILOR, it is located on SYSVOL. 
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EXAMPLE OF ALLOCATION: 


PREALLOC SYS.GSF.UFAS, DVC=MS/FSA, UNIT=BLOCK, 
GLOBAL=(MD=md, SIZE=114), INCRSIZE=57, 
UFAS= (INDEXED= (CISIZE=12288, RECSIZE=3700, 
RECFORM=V, KEYLOC=1, KEYSZ=6, 
CIFSP=20, CAFSP=20)), MAXEXT=15, EXPDATE=365, 
FILESTAT=CAT, CATNOW, CAT=n; 


TAILOR Commands: 


GSFGEN, SYSVOL, RSDVOL, RSDVOL1. 
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A.45 The SYS.HBINLIB File 


File Name 


SYS.HBINLIB 


Domain 


GCOS 


Function 
This file contains binary objects such as: 


e GCL procedures 
e Forms 


e Schemas (data dictionary). 


Organization 

Library 

Sizes 

SIZE (BLOCK) 1870 
INCRSIZE (BLOCK) 170 
MAXSIZE (BLOCK) 4420 
Location 


The SYS.HBINLIB file must be allocated on the system disk. 
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EXAMPLE OF ALLOCATION: 


PREALLOC SYS.HBINLIB, UNIT=BLOCK, 
DVC=MS/FSA, GLOBAL=(MD=md, SIZE=1870), 
LINKQD= (NONE= (TYPE=BIN, BLKSIZE=8166, 
RECSIZE=1024, LTRKSZ=1, MAXSIZE=4420, 
DIRSIZE=10, NDLREC, RECFORM =VB)), 
INCRSIZE=170, CATNOW, FILESTAT=CAT, CAT=n; 


TAILOR Commands: 
Not visible to TAILOR language. 
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A.46 The SYS.HBINLIB2 File 


File Name 


SYS .HBINLIB2 


Domain 


OLTD 
Function 


This file contains the On-Line Test and Diagnostic (OLTD) binary modules. 


Organization 


Library 


Size 


SIZE (BLOCK) 500 


Location 


This is a mandatory file that must be located on the FSA disk that contains the 
SYS.CATALOG file. 


EXAMPLE OF ALLOCATION: 


LIBALLOC BIN, (SYS.HBINLIB2, UNIT=BLOCK, MD=md, DVC=MS/FSA, 
SIZE=(500, 85), CATNOW, FILESTAT=CAT, 
CAT=n), MEMBERS=20; 


TAILOR Commands: 


Not visible to TAILOR language. 
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A.47 The SYS.HCULIB File 
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File Name 


SYS .HCULIB 


Domain 


GCOS 
Function 


This file contains system Compile Units. 


Organization 


Library 


Size 


SIZE (BLOCK) 170 


Location 


This is a mandatory file that may be located on any FSA disk. If copied by 
TAILOR, it is located on SYSVOL. 
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EXAMPLE OF ALLOCATION: 


PREALLOC SYS.HCULIB, DVC=MS/FSA, UNIT=BLOCK, 
GLOBAL=(MD=md, SIZE=170), 
LINKQD= (NONE= (BLKSTZE=4070, RECSIZE=1024, 
TYPE=CU, LTRKSZ=1, NDLREC, DIRSIZE=1, 
RECFORM=VB) ) , 

NCRSIZE=340, FILESTAT=CAT, CATNOW, CAT=n; 


TAILOR Commands: 
Not TAILOR-visible. 
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A.48 The SYS.HELP File 
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File Name 


SYS . HI 


ELP 


Domain 


GCOS 


Function 


System File Descriptions 


This file contains help texts for GCL commands in English (default value). 


Organization 


Library 


Sizes 


SIZE 


BLOCK) 


INCRSIZE (BLOCK) 
MAXSIZE (BLOCK) 


Location 


5440 
170 
10200 


This is a mandatory file that may be located on any FSA disk. If copied by 


TAILOR, it is located on SYSVOL. 
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EXAMPLE OF ALLOCATION: 


PREALLOC SYS.HELP, DVC=MS/FSA, UNIT=BLOCK, 
GLOBAL=(MD=md, SIZE=5440), 

LINKQD= (NONE= (BLKSIZE=1024, RECSIZE=264, 

TYPE=SL, LTRKSZ=1, NDLREC, MAXSIZE=10200, 

RECFORM=VB, DIRSIZE=252, COMPACT) ), 

NCRSIZE=170, FILESTAT=CAT, CATNOW, CAT =n; 


TAILOR Commands: 
Not visible to TAILOR language. 
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A.49_ The SYS.HLMLIB File 


File Name 


SYS .HLMLIB 


Domain 


GCOS 


Function 


This file contains the Load Modules belonging to the system utilities; e.g., the 
COBOL compiler, the file and volume utilities. 


Organization 

Library 

Sizes 

SIZE (BLOCK) 4930 
INCRSIZE (BLOCK) 170 
MAXSIZE (BLOCK) 10625 
Location 


This is a mandatory file that may be located on any FSA disk (preferably the 
system disk). If TAILOR makes a copy, the file is located on SYSVOL. 


1(2)3 IMPORTANT: 
Ea This file must not contain any user members. 
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EXAMPLE OF ALLOCATION: 


PREALLOC SYS.HLMLIB, EXPDATE=365, DVC=MS/FSA, UNIT=BLOCK, 

GLOBAL=(MD=md, SIZE=4930), 
LINKQD= (NONE= (TYPE=LM, BLKSIZE=4070, 
RECSIZE=1024, RECFORM=VB, NDLREC, DIRSIZE=7, 
LTRKSZ=1, MAXSIZE=10625)), INCRSIZE=170, 
FILESTAT=CAT, CATNOW, CAT=n; 


TAILOR Commands: 


Not TAILOR-visible. 
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A.50 The SYS.HLMLIB2 File 


File Name 


SYS .HLMLIB2 


Domain 


OLTD 


Function 


This file contains Load Modules used by OLTD, the test and diagnostic facilities. 


Organization 

Library 

Sizes 

SIZE (BLOCK) 1400 
INCRSIZE (BLOCK) 80 
MAXSIZE (BLOCK) 2120 
Location 


This is a mandatory file that must be located on the FSA disk that contains the 
SYS.CATALOG file. 


EXAMPLE OF ALLOCATION: 


LIBALLOC LM, (SYS.HLMLIB2, UNIT=BLOCK, MD=md, DVC=MS/FSA, 
SIZE=(1400, 80), CATNOW, FILESTAT=CAT, 
CAT=n), MAXSIZE=2120, MEMBERS=60; 


Q 


TAILOR Commands: 
Not TAILOR-visible. 
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A.51 


A-74 


The SYS.HRELLIB2 File 


File Name 


SYS .HRELLIB2 


Domain 


OLTD 


Function 


This file contains a source member and space reserved for members created by the 
test and diagnostic facilities. 


Organization 


Library 


Size 


SIZE (BLOCK) 133 


Location 


This is a mandatory file that must be located on the FSA disk that contains the 
SYS.CATALOG file. 


EXAMPLE OF ALLOCATION: 


LIBALLOC SL, (SYS.HRELLIB2, UNIT=BLOCK, MD=md, DVC=MS/FSA, 
SIZE=(133, 85), CATNOW, FILESTAT=CAT, 
CAT=n), MEMBERS=50; 


TAILOR Commands: 
Not TAILOR-visible. 
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A.52 The SYS.HSLLIB File 


File Name 


SYS .HSLLIB 


Domain 


GCOS 


Function 


This file contains source elements (mainly in JCL) for the system. 


Organization 

Library 

Sizes 

SIZE (BLOCK) 1280 
INCRSIZE (BLOCK) 170 
MAXSTIZE (BLOCK) 2380 
Location 


This is a mandatory file that may be located on any FSA disk (preferably the 
system disk). If copied by TAILOR, it is located on SYSVOL. 


1(2)3 IMPORTANT: 
lean This file must not contain any user sub-files. 
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EXAMPLE OF ALLOCATION: 


PREALLOC SYS.HSLLIB, EXPDATE=365, DVC=MS/FSA, UNIT=BLOCK, 

GLOBAL=(MD=md, SIZE=1200), 
LINKQD= (NONE= (BLKSIZE=4070, RECSIZE=264, 
RECFORM=VB, TYPE=SL, NDLREC, COMPACT, DIRSIZE=8, 
LTRKSZ=2, MAXSIZE=2380) ) , INCRSIZE=170, 
FILESTAT=CAT, CATNOW, CAT=n; 


TAILOR Commands: 


Not visible in TAILOR language. 
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A.53 The SYS.HSLLIB2 File 


File Name 


SYS.HSLLIB2 


Domain 


OLTD 


Function 


This file contains source members used by the test and diagnostic facilities. 


Organization 


Library 


Size 


SIZE (BLOCK) 1190 


Location 


This is a mandatory file that may be located on any resident FSA disk, but should 
be on the same disk as the SYS.CATALOG file. 


EXAMPLE OF ALLOCATION: 


LIBALLOC SL, (SYS.HSLLIB2, MD=md, DVC=MS/FSA, UNIT=BLOCK, 
SIZE=(1190, 85), CATNOW, FILESTAT=CAT, 
CAT=n), COMPACT, MEMBERS=250; 


TAILOR Commands: 
Not TAILOR-visible. 
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A.54 The SYS.HUB File (not applicable for XTA Systems) 


File Name 


SYS .HUB 


Domain 


FW 


Function 


This file contains system firmware for Central Processor Unit initialization. 
SYS.HUB is created and loaded using the FGF function BLOAD. 


Organization 


NONE 


Size 


SIZE (BLOCK) 1000 


Location 


This file must be on the system disk. 
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A.55 The SYS.HUB7 File (not applicable for XTA Systems) 
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Applicable only to file loaded by BSRP2 and mandatory for 
DPS 7000/TAxxx/TAxxxC, and DPS 7000/MTx2 and up. 


File Name 


SYS .HUB7 


Domain 


FW 


Function 


This file contains system firmware for Central Processor Unit initialization. 
SYS.HUB7 is created and loaded using the FGF function BLOAD. 


Organization 


NONE 


Size 


SIZE (BLOCK) 1000 


Location 


This file must be on the system disk. 
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A.56 The SYS.HUBG File 


File Name 


SYS .HUBG 


Domain 


FW 


Function 


This file contains firmware used by the SIP (System Initialization Program) and 
PIAR (Peripheral Integrity Assurance Routine) functions. SYS.HUBG is created 
or updated using the FGF function BLOAD. 


Organization 

Library 

Sizes 

SIZE (BLOCK) 2500 
INCRSIZE (BLOCK) 250 
Location 


This file must be on the system disk. 
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File Name 


SYS.IN 


Domain 


GCOS 


Function 


System File Descriptions 


The Stream Reader uses this file to store JCL statements and job input enclosures. 


Organization 


Queued Linked 


Sizes 


SIZE (BLOCK) 


INCRSIZE 
MAXSIZE ( 


Location 


(BLOCK) 


BLOCK) 


170 
170 
680 


This is a mandatory file that may be located on any resident FSA disk. If 
preallocated by TAILOR, it is located on SYSVOL. 


To reallocate a SYS.IN file (in case of a problem, or to change its size), you 
proceed as follows: 


1. Rename the existing file: 


MDF SYS1.SYS.IN SYS1.SYS.OLD 


2. Allocate the new file: 
PREALLOC SYS1.SYS.IN ... 


3. Terminate the system normally. 


I 
or 
ag 


LO1 


LO1 


RESTART (COLD 


= 


RESTART (CLEAN) 
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4. Delete the old file: 
DLF SYS1.SYS.OLD BYPASS 


If you do not have a backup of your system and need to expand the SYS_IN file, or 
if there are problems with the file such as I/O errors, proceed as follows: 


e use the allocation example below, 
e delete the old SYS.IN file, 
e provoke a system crash, 


e perform a RESTART(COLD) at ILO1 options. 


EXAMPLE OF ALLOCATION: 


PREALLOC SYS1.SYS.IN, UNIT=BLOCK, DVC=MS/FSA, 
GLOBAL=(MD=md, SIZE=170), 

LINKQD= (TYPE=NONE, BLKSIZE=4070, RECSIZE=264, 

LTRKSZ=1, MAXSIZE=680, RECFORM=VB, NDLREC, 

DIRSIZE=8) , INCRSIZE=170, 

FILESTAT=UNCAT, EXPDATE=365; 


TAILOR Commands: 


SYIN, SYSVOL 
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A.58 The SYS.IUF File 
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File Name 


sys.I 


UF 


Domain 


GCOS 


Function 


System File Descriptions 


This file is used by TAILOR as well as by the IUF functions and jobs. 


Organization 


Library 


Sizes 


SIZE 


BLOCK) 


INCRSIZE (BLOCK) 


Location 


1020 
170 


This is a mandatory file that may be located on any FSA disk. If preallocated by 


TAILOR, it is located on SYSVOL. 
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EXAMPLE OF ALLOCATION: 


PREALLOC SYS.IUF, UNIT=BLOCK, EXPDATE=365, DVC=MS/FSA, 
GLOBAL=(MD=md, SIZE=1020), 
LINKQD= (BLKSIZE=4070, RECSIZE=264, 
RECFORM=VB, TYPE=SL, NDLREC, 

DIRSIZE=8, LTRKSZ=1, COMPACT), 

INCRSIZE=170, FILESTAT=CAT, CATNOW, CAT=n; 


TAILOR Commands: 


Not visible to TAILOR language. 
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A.59 The SYS.JADIR File 


File Name 


SYS.JADIR 


Domain 


GCOS 


Function 


This file is used by the JAS facility. 


Organization 


Queued Linked 


Sizes 


SIZE (100KB) 120 
INCRSIZE (100KB 3) 
MAXSIZE (100KB) 4000 


oS 


Location 


This is an optional file that may be located on any FSA resident disk, preferably the 
system disk. However, it must be cataloged in the SYS.CATALOG 


TAILOR Commands: 
Not visible to TAILOR language. 


SYS.JADIR is created by the MAINTAIN_JAS utility. For more information, refer 
to the File Recovery User's Guide. 
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A.60 The SYS.JASBLUE File 


File Name 


SYS .JASBLUE 


Domain 


GCOS 


Function 


Used with TDS-HA (TDS High Availability), this is an output file for a JAS server 
that guarantees integrity of files. 


Organization 


Queued Linked 


Size 


SIZE (BLOCK) 3 


Location 

This is an optional file that may be located on any FSA resident disk, preferably the 
system disk. However, it must be cataloged in the SYS.CATALOG 

TAILOR Commands: 


JAS, SYSVOL, RSDVOL, RSDVOL1, NRDVOL, NRDVOL1 


GIUF Command: 


BUILD_JAS 
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A.61 The SYS.JASGREEN File 


File Name 


SYS .JASGREEN 


Domain 


GCOS 


Function 


Used with TDS HA (High Availability), this is an output file for a JAS server that 
guarantees integrity of files. 


Organization 


Queued Linked 


Size 


SIZE (BLOCK) 3 


Location 


This is an optional file that may be located on any FSA resident disk. 


TAILOR Commands: 


JAS, SYSVOL, RSDVOL, RSDVOL1, NRDVOL, NRDVOL1 


GIUF Command: 


BUILD_JAS 
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A.62 The SYS.JRNAL File 


File Name 


SYS .JRNAL 


Domain 


GCOS 


Function 


This file is used by the Before Journal facility. 


Organization 
Non-standard 
Size 


SIZE (512 bytes) 16368 


Location 


This is an optional file that may be located on any FSA disk, but preferably the 
system disk. If preallocated by TAILOR, it may be located on SYSVOL, 
RSDVOL, RSDVOL1, NRDVOL, or NRDVOLI. 

TAILOR Commands: 


JBEFORE, SYSVOL, RSDVOL, RSDVOL1, NRDVOL, NRDVOL1 


GIUF Command: 


BURNAL 
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A.63 The SYS.JTRAVAL[i] File 


File Name 


SYS .JTRAVAL [i] [where i = 0 or 1] 


Domain 


GCOS 


Function 


This file is used by JTRA to store temporary information about the expansion of 
the values in a JCL sequence. 


Organization 


UFAS SEQ 


SIZE (BLOCK) 5000 


Location 


This is an optional file which is automatically allocated by JTRA on any FSA 
resident disk. 


TAILOR Commands: 
Not TAILOR-visible. 
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A.64 


A-90 


The SYS.KNODET File 


File Name 


SYS .KNODET 


Domain 


GCOS 


Function 


This file is used by GCOS 7 to store control information about active jobs. 


Organization 


Non-standard 


Size 


SIZE (BLOCK) 85 


Location 


This is a mandatory file that must be located on a FSA resident disk. If 
preallocated by TAILOR, it may be located on SYSVOL, RSDVOL, or 
RSDVOLI. 


To reallocate a SYS.KNODET file (in case of a problem, or to change its size), you 
proceed as follows: 


1. Rename the existing file: 


MDF SYS1.SYS.KNODET SYS1.SYS.OLD 


2. Allocate the new file: 
PREALLOC SYS1.SYS.KNODET ... 


3. Terminate the system normally. 
ILO1 RESTART (COLD) 


or 


ILO1 RESTART (CLEAN) 
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System File Descriptions 


4. Delete the old file: 
DLF SYS1.SYS.OLD BYPASS 


If you modify the size of this file, you must perform RESTART (CLEAN) before 
attempting to use the system. 


EXAMPLE OF ALLOCATION: 


PREALLOC SYS.KNODET, UNIT=BLOCK, MAXEXT=1, 
DVC=MS/FSA, GLOBAL=(MD=md, SIZE=85), 
NONE= (BLKSIZE=16384), INCRSIZE=170, EXPDATE=365, 
CATNOW, FILESTAT=CAT, CAT=n; 


TAILOR Commands: 


KNODET, SYSVOL, RSDVOL, RSDVOL1 


SYS.KNODET SIZE EVALUATION 
Three parameters are supplied by CONFIG: 
MAXFILE the maximum number of active files. 


FILSHARE the maximum number of process groups allowed to 
share a file. 


MAXDEF the maximum of active DEFINE statements. 


These three parameters are used in the following evaluations: 


BKSZ the block size of KNODET (over-ridden at run-time). 
DEFBK the number of blocks used for DEFINES. 
KNBK the number of blocks required to be accommodated in 
SYS.KNODET. 
FORMULAS 


BKSZ=(52 * filshare) + 416 
DEFBK=first integer greater than (maxdef * 150) / bksz) +1 


KNBK=maxfile + defbk 
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If SYS.KNODET file size is too small, the system automatically reduces the 
MAXFILE and MAXDEF limits set by CONFIG, and issues the warnings: 


DFO4 MAXIMUM NUMBER OF ASSIGNED FIL 


ES HAS BEEN REDUCED TO xxx 


DFO5 MAXIMUM NUMBER OF DEFINES HAS BEEN REDUCED TO xxx 
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File Name 


SYS.LIB, SYS.LIB[i] (where 


Domain 


GCOS 


Function 
These files contain: 


e Preinitialized Load Modules 


e Sharable Modules 


System File Descriptions 


i = from 1 to 15) 


e Checkpoint/Restart information. 


Organization 


Non-standard 


Sizes 

SIZE (BLOCK) 11900 
MAXSIZE (BLOCK) 65535 
Location 


Whereas the SYS.LIB file is mandatory, the SYS.LIBi files (where i is in the range 
1 to 15) are optional. Each may be multi-extent but must be mono-volume. These 
files may be located on any FSA resident or non-resident disk by the IUF function 
BUILD _LIB. SYS.LIB may alternatively be preallocated using TAILOR. 


The SYS.LIBi files cannot be allocated on mirror disks. 


TAILOR Commands: 


LIB, SYSVOL, RSDVOL, RSDVOL1, NRDVOL, NRDVOL1 


GIUF Command: 


BUILD_LIB 
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A.66 


A-94 


The SYS.LOGC File 


File Name 


SYS . LOGC 


Domain 


GCOS 


Function 


This file contains all the messages sent to and from the MAIN console. 


Organization 


Non-standard 


Size 
SIZE (BLOCK) 240 


Location 


This is an optional file which may be located on any FSA disk. If required, it is 
preallocated by TAILOR on SYSVOL, RSDVOL, or RSDVOLI. 


EXAMPLE OF ALLOCATION: 


As SYS.LOGC must be cataloged with specific sharability attributes, its creation 
requires two steps: 


CATALOG SYS.LOGC SHARE=ONEWRITE CATALOG=n; 

PREALLOC SYS.LOGC, UNIT=BLOCK, DVC=MS/FSA, 
GLOBAL=(MD=md, SIZE=240), EXPDATE=365, 
NONE= (BLKSIZE=4096) , INCRSIZE=170, 
FILESTAT=CAT, CAT=n, CATNOW; 

Q) 

TAILOR Commands: 


LOGC, SYSVOL, RSDVOL, RSDVOL1 
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File Name 


SYS .OUT 


Domain 


GCOS 


Function 


System File Descriptions 


This is the standard output file intended to contain output from jobs, for subsequent 


printing. 


Organization 


Queued Linked 


Sizes 


SIZE (BLOCK) 
INCRSIZE (BLOCK) 


MAXSIZE (BLOCK) 
BLKSIZE (BLOCK) 
RECSIZE (BLOCK) 
LTRKSZ (BLOCK) 
DIRSIZE (BLOCK) 
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Location 


This mandatory file may be distributed over up to 10 resident disks, but should if 
possible be located on the system disk. If required, it can be preallocated by 
TAILOR on SYSVOL, RSDVOL, and/or RSDVOLI (i.e. a maximum of 

3 different disks). File creation may be performed using PREALLOC in order to 
include resident volume(s) other than RSDVOL and RSDVOLI. 


To reallocate a SYS.OUT file (in case of a problem, or to change its size), you 
proceed as follows: 


1. Rename the existing file: 


MDF SYS1.SYS.OUT SYS1.SYS.OLD 


2. Allocate the new file: 
PREALLOC SYS1.SYS.OUT ... 


3. Terminate the system normally. 


ILO1 RESTART (COLD) 


or 


ILO1 RESTART (CLEAN) 


4. Delete the old file: 
DLF SYS1.SYS.OLD BYPASS 


If you do not have a backup of your system and need to expand the SYS.OUT file, 
or if there are problems with the file such as I/O errors, proceed as follows: 


e delete the old SYS.OUT file 
DLF SYS1.SYS.OUT 


e use the "Example of Allocation" below, or execute the following JCL sequence: 


EJ IUF_PREA_SYSOUT..SYS.IUF 
VL= (MDNAME, SIZE, MDNAME1, SIZE1, ...) 


e provoke a system crash, 


e perform a RESTART(COLD) at ILO1 options. 


A-96 47 A2 23US 


System File Descriptions 


EXAMPLE OF ALLOCATION: 


PREALLOC SYS1.SYS.OUT, DVC=MS/FSA, UNIT=BLOCK, 
SPLIT=((mdname, SIZE=340), (mdnamel, SIZE=sizel), 
(mdname2, SIZE=size2)), LINKQD=(TYPE=NONE, 
BLKSIZE=8166, RECSIZE=4024, MAXSIZE=32000, 
LTRKSZ=5, RECFORM=VB, NDLREC, DIRSIZE=8), 
INCRSIZE=85, FILESTAT=UNCAT, EXPDATE=365; 


TAILOR Commands: 


SYO, SYSVOL, RSDVOL, RSDVOL1 
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A.68 


A-98 


The SYS.PVMF[I] File(s) 


File Name 


SYS.PVMF, SYS.PVMF[i] (where i = from 1 to 15) 


Domain 


GCOS 
Function 


These files contain permanent virtual memory files. 


Organization 


Non-standard 


Sizes 

SIZE (BLOCK) 5100 
MAXSIZE (BLOCK) 65535 
Location 


While the SYS.PVMF file is mandatory, the SYS.PVMFi files (where i is in the 
range | to 15) are optional. Each may be multi-extent but must be mono-volume. 
These files may be located on any resident or non-resident disk by the IUF function 
BUILD_PVMF. SYS.PVMF may alternatively be preallocated using TAILOR. 


The SYS.PVMFi files cannot be allocated on mirror disks. 


TAILOR Commands: 


PVMF, SYSVOL, RSDVOL, RSDVOL1, NRDVOL, NRDVOL1. 


GIUF Command: 


BUILD_PVMF 
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A.69 The SYS.QM File 
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File Name 


SYS .QM 


Domain 


GCOS 


Function 


This file contains system directives together with the associated answers. The file 
is accessed by the operator station Queue Manager and replaces the Operator 
Message Handler mailboxes accessed by the operator station Queue Manager in 
previous releases. 


Organization 


UFAS Relative 


Size 


SIZE (CI) 500 


Location 


This is a mandatory file that may be located on any FSA resident disk. 
If created by TAILOR, it may be located on SYSVOL, RSDVOL, RSDVOLI, 
NRDVOL, or NRDVOLI1. 


SYS.QM must be allocated on a disk that contains a backing store file. 


TAILOR Commands: 


QM, SYSVOL, RSDVOL, RSDVOL1, NRDVOL, NRDVOL1. 


GIUF Command: 


BUILD_QM 
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A.70 


A-100 


The SYS.QM_BACKUP File 


File Name 


SYS .QM_ BACKUP 


Domain 


GCOS 


Function 


This file contains system directives together with the associated answers. The file 
is accessed by the operator station Queue Manager and replaces the Operator 
Message Handler mailboxes accessed by the operator station Queue Manager in 
previous releases. 


Organization 


UFAS Relative 


Size 
SIZE (CI) 500 


Location 


This is a mandatory file that may be located on any FSA resident disk. 
If created by TAILOR, it may be located on SYSVOL, RSDVOL, or RSDVOLI, 
NRDVOL, NRDVOLI. 


SYS.QM BACKUP must be allocated on a disk that contains a backing store file. 


TAILOR Commands: 


QMBACK, SYSVOL, RSDVOL, RSDVOL1, NRDVOL, NRDVOL1. 


GIUF Command: 


BUILD_QMBACKUP 
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A.71 The SYS.SITE.BIN File 
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File Name 


SYS.SITE.BIN 


Domain 


GCOS 


Function 


This file is allocated by GCOS 7, in order to contain site-specific items in binary 
format used by the FW, OLTD and GSF Domains. 


Organization 


Library 
Size 
SIZE (BLOCK) 450 


Location 


This is a mandatory file that may be located on any FSA disk. If copied by 
TAILOR, it is located on SYSVOL. 


EXAMPLE OF ALLOCATION: 


LIBALLOC BIN, (SYS.SITE.BIN, UNIT=BLOCK, 
DVC=MS/FSA, MD=md, SIZE=(450,170), 
CATNOW, FILESTAT=CAT, CAT=n), 
[EMBERS=1000; 


Q 


TAILOR Commands: 
Not visible to TAILOR language. 


A-101 


GCOS 7 System Installation Configuration and Updating Guide 


A.72 The SYS.SITE.SL File 


File Name 


SYS.SITE.SL 


Domain 


GCOS 


Function 


This file is allocated by GCOS 7, in order to contain site-specific source-format 
items used by the FW, OLTD, and GSF Domains. 


Organization 


Library 


Size 


SIZE (BLOCK) 450 


Location 


This is a mandatory file that may be located on any FSA disk. If copied by 
TAILOR, it is located on SYSVOL. 


EXAMPLE OF ALLOCATION: 


LIBALLOC SL, (SYS.SITE.SL, UNIT=BLOCK, DVC=MS/FSA, MD=md, 
SIZE=(450, 170), CATNOW, FILESTAT=CAT, 
CAT=n) , MEMBERS=1000; 


Q 


TAILOR Commands: 


Not visible to TAILOR language. 
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A.73. The SYS.SPDUMP File 


File Name 


SYS .SPDUMP 


Domain 


GCOS 


Function 


This is the standard output file, intended to contain binary dumps from the system 
processorand TDS jobs. These dumps are to be saved for analysis by the Bull 
Service Center. 


Organization 


Linked Queued 


Size 


SIZE (BLOCK) 7500 


Location 


This is a mandatory file that may be located on any FSA disk. If created by 
TAILOR, it may be located on SYSVOL, RSDVOL, RSDVOL1, NRDVOL, or 
NRDVOLI. 


TAILOR Commands: 


SPDUMP, SYSVOL, RSDVOL, RSDVOL1, NRDVOL, NRDVOL1 


GIUF Command: 


BUILD_SPDUMP 
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A.74 The SYS.SPOOL{i] File(s) 


File Name 


SYS.SPOOLi (where i = from 0 to 9) 


Domain 


GCOS 


Function 


The SPOOL files contain the active GCL procedures and environment associated 
with the GCL user. 


Organization 


Linked Queued 


Sizes 


SIZE (BLOCK) 1360 
INCRSIZE (BLOCK) 170 


Location 


At least one SPOOL file is mandatory. SPOOL files may be located on any FSA 
resident disk. It is recommended that SPOOL files be distributed over several 
disks. The number of SPOOL files depends upon the number of users: 


Ideally, there should be between 15 and 20 IOF users per spool file, but never more 
than 25 users. 
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Note that, if SYS.SPOOLi is allocated on a disk which is specified at ISL time as 
being either NON RESIDENT or NON SHARED, the JCL statements, VOLSAVE, 
VOLREST, VOLDUPLI or the GCL procedures SAVE DISK, RESTORE DISK 
will be prevented by the system from working on the disk concerned. Should such 
a situation occur, use of the JCL statements FILSAVE, FILREST, FILDUPLI or the 
GCL procedures SAVE_FILE, RESTORE_FILE, COPY_FILE is mandatory. 


SYS.SPOOLO is preallocated by TAILOR on SYSVOL, RSDVOL, or RSDVOLI. 


TAILOR Commands: 


SPOOL, SYSVOL, RSDVOL, RSDVOL1 


GIUF Command: 


BUILD_SPOOL 
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A.75 The SYS.SWLOG File 


File Name 


SYS . SWLOG 


Domain 


GCOS 


Function 


This file contains events recorded by the Trace System, for access by the Extractor 
service job TRCEXTR. 


Organization 


UFAS Relative 


Size 


SIZE (BLOCK) 800 


Location 


This is a mandatory file that may be located on any FSA disk, resident or 
non-resident. It must be present in order to allow the Collector service job to start. 
If created by TAILOR, it is located on SYSVOL, RSDVOL, RSDVOLI, 
NRDVOL, or NRDVOL1. 
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EXAMPLE OF ALLOCATION: 


CATALOG SYS.SWLOG, SHARE=FREE, DUALSHR=NONE; 


PREALLOC SYS.SWLOG, UNIT=BLOCK, DVC=MS/FSA, 
GLOBAL=(MD=md, SIZE=800), MAXEXT=1, 
UFAS= (RELATIVE= (CISIZE=4096, RECSIZE=4082, 
RECFORM=FB)), EXPDATE=999, CATNOW, 
FILESTAT=CAT, CAT=n; 


TAILOR Commands: 


SYSVOL, RSDVOL, RSDVOL1, NRDVOL, NRDVOL1, SWLOG 
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A.76 The SYS.SYSDUMP File 


File Name 


SYS .SYSDUMP 


Domain 


GCOS 


Function 


This file is used to store the memory dump (i.e., all the data for all the processes 
present in memory) in the event of a system crash. 


The size of SYS.SYSDUMP does not depend on memory size, but on the number 
of jobs that are active. The number of active jobs allowed increases as memory 
size increases. 


Organization 


Non-standard 


Sizes 


SIZE (BLOCK) 11730 
MAXSIZE (BLOCK) 65535 
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Location 


This is a mandatory file that may be located on any FSA disk. If preallocated by 
TAILOR, or alternatively using the IUF utility BUILD_SYSDUMP, it may be 
located on SYSVOL, RSDVOL, or RSDVOLI1. 


The SYS.SYSDUMP file cannot be allocated on mirror disks. 
The GIUF function BUILD_SYSDUMP is mandatory to rebuild this file. 


The default value shown under SIZE above (and in the table GCOS 7 File Domain 
Default Values in the chapter TAILOR) is appropriate for an average system load. 


TAILOR Commands: 


SYSDUMP, SYSVOL, RSDVOL, RSDVOL1 


GIUF Command: 


BUILD_SYSDUMP 
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A.77 The SYS.SYSTEM File 


File Name 


SYS.SYSTEM 


Domain 


GCOS 


Function 


This file contains the backing-store image of the operating system, and is copied to 
backing store by ISL-RESTORE when starting a system session. 


Organization 


UFAS Indexed 


Sizes 


SIZE (BLOCK) 3397 
CISIZE (BLOCK) 16384 


Location 


This is a mandatory file that may be located on any resident or non-resident FSA 
disk. If created by TAILOR, it may be located on SYSVOL, RSDVOL, 
RSDVOL1, NRDVOL, or NRDVOLI. 


The SYS.SYSTEM file cannot be allocated on mirror disks. 
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EXAMPLE OF ALLOCATION: 


PREALLOC SYS.SYSTEM, UNIT=BLOCK, MAXEXT=16, 
DVC=MS/FSA, GLOBAL=(MD=md, SIZE=3397), 
UFAS= (INDEXED= (CISIZE=16384, RECSIZE=4096, 
KEYLOC=1, KEYSIZE=9, RECFORM=V)), INCRSIZE=215, 
VERSION=CURRENT, CATNOW, FILESTAT=CAT, CAT=n; 


Note that the GCL command BSYS may be used for this file allocation. 
Q 


TAILOR Commands: 


ISL, SYSVOL, RSDVOL, RSDVOL1, NRDVOL, NRDVOL1 
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A.78 


A-112 


The SYS.SYSTEM2 File 


File Name 


SYS.SYSTEM2 


Domain 


OLTD 


Function 


This file contains Sharable Modules used by the test and diagnostic utility. 


Organization 


UFAS Indexed 


Sizes 


SIZE (CI) 43 
CISIZE (BLOCK) 12800 


Location 


This is a mandatory file that should be located on the same FSA resident disk that 
contains the SYS.CATALOG file. If created by TAILOR, it is located on 
SYSVOL. 


EXAMPLE OF ALLOCATION: 


PREALLOC SYS.SYSTEM2, UNIT=BLOCK, MAXEXT=16, 
DVC=MS/FSA, GLOBAL=(MD=md, SIZE=43), 
UFAS= (INDEXED= (CISIZE=12800, RECSIZE=4096, 
KEYLOC=1, KEYSIZE=9, RECFORM=V) ), 
INCRSIZE=43, CATNOW, FILESTAT=CAT, CAT=n, 
EXPDATE=365, VERSION=CURRENT ; 


Q 


TAILOR Commands: 
Not TAILOR-visible. 
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A.79 The SYS.TVMF[I] File(s) 
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File Name 


SYS.TVMF, SYS.TVMF[i] (where i = from 1 to 15) 


Domain 


GCOS 
Function 


These files are used for storing temporary virtual memory files. 


Organization 


Non-standard 


Sizes 

SIZE (BLOCK) 2550 
MAXSIZE (BLOCK) 65535 
Location 


Although the SYS.TVMF file is mandatory, the SYS.TVMFi files (where i is in the 
range | to 15) are optional. Each SYS.TVMFi file may be multi-extent but must 
be mono-volume. These files may be located on any resident or non-resident disk 
by the IUF function BUILD_TVMF. SYS.TVMF may alternatively be 
preallocated using TAILOR. 


The SYS.TVMFi files cannot be allocated on mirror disks. 


TAILOR Commands: 


TVMF, SYSVOL, RSDVOL, RSDVOL1, NRDVOL, NRDVOL1 


GIUF Command: 


BUILD_TVMF 
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A.80 The SYS.URCINIT File 


File Name 


SYS .URCINIT 


Domain 


GCOS 


Function 

This file contains the control tables used with unit record devices: printer character 
sets and VFU's. 

Organization 


Queued Linked 


SIZE (BLOCK) 170 


Location 


This is a mandatory file, which may be located on any FSA resident disk. If 
created by TAILOR, it is located on SYSVOL. 


EXAMPLE OF ALLOCATION: 


PREALLOC SYS.URCINIT, UNIT BLOCK, 

DVC=MS/FSA, GLOBAL=(MD=md, SIZE=170), 

LINKQD= (TYPE=NONE, BLKSIZE=4070, RECSIZE=580, 
LTRKSZ=1, DIRSIZE=1, RECFORM=VB), EXPDATE=365, 
CATNOW, FILESTAT=CAT, CAT=n; 


Q 


TAILOR Commands: 


Not visible in TAILOR language. 
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A.81 System File Access Rights 
Table A-3. System File Access Rights (1/2) 
efn SHARE |RECOVERY WRITE READ 

SITE.CATALOG FREE i 

SITE.CMS_CSD NORMAL 

SITE.CMS _CDD_namei NORMAL 

SITE.CMS DS_namel_name2 UNSPEC 

SITE.HALOCK FREE 

SITE.HELP DIR . 

SITE.IN DIR 

SITE.MIRLOG FREE = 

SITE.STARTUP DIR = 

SYS.BKST{[i] NORMAL OPERATOR = 

SYS.BOOT NORMAL RMSIOF OPERATOR 

SYS.CATALOG FREE * 

SYS.C.INCLUDE DIR . 

SYS.CLC DIR * 

SYS.DSA* DIR OPERATOR * 

SYS.DSALOGi ONEWRITE OPERATOR * 

SYS.DSARCC _ <Ict-name>_x ONEWRITE OPERATOR * 

SYS.DSATRCIDT_<fcp-ts> ONEWRITE OPERATOR % 

SYS.ERLOG ONEWRITE OPERATOR ‘J 

SYS.FW.* DIR RMSIOF OPERATOR 

SYS.GPL.MACLIB DIR 7 

SYS.GSF.* DIR RMSIOF OPERATOR - 
TELECONTROL . 

SYS.HBINLIB DIR RMSIOF 

SYS.HBINLIB2 DIR RMSIOF OPERATOR - 

SYS.HCULIB DIR RMSIOF . 

SYS.HELP DIR OPERATOR . 

SYS.HLMLIB DIR RMSIOF 4 

SYS.HLMLIB2 DIR RMSIOF OPERATOR 

SYS.HRELLIB2 DIR RMSIOF OPERATOR 

SYS.HSLLIB DIR RMSIOF * 

SYS.HSLLIB2 DIR RMSIOF OPERATOR * 

SYS.HUB / SYS.HUB7 NORMAL RMSIOF OPERATOR = 

SYS.HUBG DIR RMSIOF OPERATOR * 

SYS.IN 
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Table A-3. System File Access Rights (2/2) 

efn SHARE |RECOVERY WRITE READ 
SYS.IUF DIR RMSIOF OPERATOR . 
SYS.JADIR DIR OPERATOR [or *] i 
SYS.JASBLUE DIR OPERATOR i 
SYS.JASGREEN DIR OPERATOR * 
SYS.JRNAL NORMAL OPERATOR [or *] * 
SYS.KNODET NORMAL RMSIOF 
SYS.LIB[i] NORMAL OPERATOR * 
SYS.LOGC ONEWRITE OPERATOR * 
SYS.OUT OPERATOR * 
SYS.PVMF[i] NORMAL OPERATOR * 
SYS.QM* NORMAL OPERATOR 
SYS.SITE* DIR * 
SYS.SPDUMP DIR * ms 
SYS.SPOOL1 NORMAL OPERATOR 3 
SYS.SWLOG FREE OPERATOR * 
SYS.SYSDUMP NORMAL OPERATOR [or *] * 
SYS.SYSTEM NORMAL RMSIOF * 
SYS.SYSTEM2 NORMAL RMSIOF OPERATOR * 
SYS.TVMF{i] NORMAL RMSIOF OPERATOR * 
SYS.URCINIT DIR 7 

NoTES: 

1. All system files have the owner SYSADMIN. 

2. The above default access rights are minima and so may never be reduced 
or cancelled by the user, although they may of course always be 
increased/added to by SYSADMIN. 
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A.82 Calculating Backing Store File Sizes 


A.82.1 General Remarks 


Backing-store space is split into 4 areas: 


e The paging backing store: SYS.BKST through SYS.BKST15 
e The library backing store: SYS.LIB through SYS.LIB15 


e The backing store for permanent virtual memory files: SYS.PVMF through 
SYS.PVMF15 


e The backing store for temporary virtual memory files: SYS.TVMF through 
SYS.TVMFI1S5. 


The system administrator must allocate sufficient space to avoid all but exceptional 
cases of backing-store overflow, without this space being so excessive as to cause 
unnecessary disk space wastage and disk drive arm displacement. Each of the 4 
areas must be calculated separately, and no single backing store file extent may 
exceed 256MB. 


The size of a backing-store file cannot exceed 65535 blocks. 


While it is usually more efficient to distribute the files belonging to each area over 
several disks, files belonging to different backing-store areas may coexist on any 
single disk volume. For example, in a small configuration, the files SYS.BKST, 
SYS.PVMF, SYS.LIB and SYS.TVMF may be located on one disk while 
SYS.BKST1, SYS.PVMF1, SYS.LIB1 and SYS.TVMF!1 are located on a second 
disk. 


Backing-store occupancy may easily be checked during normal processing by 
using the DCBS-MAP. In a "normal" phase of processing, a comfortable amount 
of backing store should remain unused. The following figures seek to be realistic, 
erring if anything on the side of pessimism. They are however only average 
estimates that cannot by definition take account of any unusual site-specific 
conditions. 

See the table Backing Store File Sizes below. 
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A.82.2 Paging Backing Store Files 


SYS.BKST file size depends on the size of the segments referenced by the JOPO 
table for its permanent part, and upon the number of dynamically created pages for 
its temporary part (which must have the same size for all of the files SYS.BKST 
and SYS.BKSTi). 


SYS.BKST file size no longer depends on main memory size. 
The contents of a SYS.BKST file may be analyzed into 3 parts: 


1. The system itself plus segments which may be created dynamically by the 
system (10MB). 
2. The crash area, MMSZ, 32MB. This is independent of main memory size. 


3. The pages belonging to each executing job. Each job needs approximately 
0.8MB of backing store, although certain applications (such as IQS and 
Oracle) need more. 


10 + 32 + 0.8 * multlev 


A bonus should be added to the resulting paging backing-store total, to allow for 
those applications that are large consumers of backing store. 


A.82.3 Library Backing Store 


The contents of the SYS.LIB[i] files may be analyzed into 3 parts: 


1. Sharable Modules (SM): system SMs account for about 25MB. User SMs are 
roughly proportional to the number of TDSs that may be loaded concurrently 
on the site (but could be much higher for a large TDS application): 


2 * NTDS 
2.  Preinitialized Load Modules (LM): the amount of space required for 
frequently-used system LMs may vary from site to site, but often accounts for 


about 1OMB. User Load Modules may vary widely, but are often related to 
the system's multiprogramming level: 


2 + 0.3 * multlev 


3. Repeatable steps and Checkpoints: based on (a) about 15% of executing jobs 
performing checkpoints, and (b) the size of each checkpoint being about 
1MB: 


The total Library Backing Store may thus be calculated as: 


37 + 0.5 * multlev + 2 * ntds 
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A.82.4 Permanent Virtual Memory Files 


The contents of SYS.PVMF[i] files may be analyzed into: 


1. Aconstant part that includes system PVMF Files, usually about SMB. 


2. Avvariable part related to the number of (a) known jobs and (b) executing 
jobs: 


24/1024 * multlev + 16/1024 * maxjob 


The total requirements for Permanent Virtual Memory Files may thus be 
calculated as: 


5 + 24/1024 * multlev + 16/1024 * maxjob 


A.82.5 Temporary Virtual Memory Files 
Only only a few GCOS 7 processors use these files. 300KB should suffice for 


executing jobs. The constant element of the system does not require more than 
1MB: 


1 * 0.3 * multlev 


A.82.6 Conversion of Megabytes to Blocks 


Conversion of MB into blocks: 


MS/FSA: 1MB = 2000 blocks 
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A.82.7 Backing Store File Sizes 


A-120 


The table below shows some typical backing store file sizes. Remember, however, 
that there are many influencing factors, in particular the number of jobs running at 


any one time. 


Table A-4. Some Typical Backing Store File Sizes (in Blocks of 4096 Bytes) 


Files 


SYS.BKST{i] 
SYS.LIB[i] 

SYS.PVMF[i] 
SYS.TVMF{i] 


Main memory Size in MBytes 


64 128 
7800 14000 
21600 39000 

9200 16600 
4700 8500 


256 
25200 
63900 
29800 
15200 
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B. SIP Functions 


NOTE: 
This appendix is not concerned for XTA systems 


B.1 SIP (System Initialization Program) 


SIP is a small Operating System, entirely resident in memory. It is designed to 
initialize a DPS 7000 system in INIT or RELOAD mode, or to monitor the 
execution of certain functions in UTIL mode when GCOS 7 is either not available, 
or not operational. 


It contains a SAVE function used to save an FSA disk and a RESTORE function 
used to restore an FSA system disk from the contents of the backup P-MEDIA 
(generated using either SAVE_DISK for each disk or through SIP). 


B.2 SIP Loading 
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SIP can be loaded in three different modes: 


INIT mode: 
SIP initializes the controllers as well as certain specific resources, such as the 
console and the printer, then loads and activates ISL (the GCOS 7 loader). 


RELOAD mode: 
SIP only loads and activates ISL. 


UTIL mode: 
SIP activates the UTILity functions. The aim of this mode is to save an FSA disk 
on tapes or cartridges without reinitializing the CSS (Central Sub-System). 


SIP requests the parameters it needs, via a dialog with the operator. 


Note that this UTIL mode is not compatible with the AUTOMATIC mode of the 
Service Processor. SIP loading is dependent on the DPS 7000 model. See the 
paragraphs below. 
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SIP is loaded by the SYC application running in the Service Processor with specific 
SYC commands entered in the SYC window: 


e in INIT mode with the commands IN/INR/IND: 


IN/INR/IND <bootload device> LD <os> <ISL device> 


e in RELOAD mode with the command RL: 


RL LD <ISL device> 


or with specific instructions after a System Reset or a GCOS 7 crash. 
e in UTIL mode with the commands IN/INR/IND and the parameter UTIL. 
IN/INR/IND <bootload device> LD UTIL 


B.3 SIP Dialog 


SIP messages are displayed on the System console. 


Messages requiring an answer begin with an asterisk (*) and end with the prompt 
"2812" or "?R?". 


There is no deferred answer mechanism equivalent to that provided under GCOS 7. 
The BRK (BREAK) key should not be used during SIP execution. 


There are no SIP commands. UTILity functions are activated by the operator's 
answers to SIP messages requiring a response. 
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B.4 UTILity Functions Under SIP 


In the event of a problem with your P-Set, use SIP in UTIL mode. If you are 
unable to initialize GCOS 7 and thus need to restore each disk belonging to your 
P-Set from the P-Tapes (or cartridges), this may be done by supplying an R MSxx 
answer to the INIT20 request message. On the systems with FSA disks you can 
save data disks if necessary before restoring, this may be done by supplying an S 
MSxx answer to the INIT20 request message. 


When the RESTORE, or SAVE, function has completed, this INIT20 request is 
displayed again. You may leave UTIL mode and initialize the system from the 
newly restored Set, by giving the I MSxx answer. 


To perform a RESTORE function under SIP, you need to know the P-Set file name. 
This file name should not be confused with the media names. 


NOTE: 
Be careful to enter the correct file name because the system could take up to 
half an hour to search through the whole set of media before declaring that it 
cannot find a file. 


These procedures under SIP restore or save a whole disk at a time. No 
manipulation of individual files is possible. 


When an FSA disk is saved under SIP, CATALOG information is not saved in the 
SAVE file. The SAVE file can be restored under GCOS 7 by RESTORE _DISK or 
RESTORE_FILE GCL procedure, however the operator must update the 
CATALOG files if necessary. 


B.5 Execution Example 
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The first request allows three functions to be executed: 


* INIT20 UTIL FUNCTION: INIT, RESTORE, SAVE. 
REPLY (I MSXX, R MSXX, S MSXX) 


?R? 

I MSXx Leave UTIL mode and initialize the system from the 
corresponding MS. 

RMSXX Restore the corresponding FSA disk. 

S MSXxX Save the corresponding FSA disk. 


GCOS 7 System Installation Configuration and Updating Guide 


B.5.1 


B-4 


The RESTORE Function 


1. Before executing the RESTORE function SIP requests all the necessary 
parameters. 


a. 


SIP requires the device on which the media containing the SAVE file 
(or the first media if the image is stored on several media) is mounted: 
* INIT44 GTDV DEFINE FIRST INPUT TAPE DEVICE. 

REPLY (UD <DEVICE>, CR) 
?R?UD MTO1 


The device can be any tape, cassette, or cartridge that is currently 
supported. This device must be declared in the IRT and must be 
available. 

If there are several SAVE images stored on the same media, the operator 
can specify the image to be restored, as follows: 


* INIT21 MT01 DEFINE SAVE FILE NAME. (DEFAULT VALUE=FSA41) 
PR? 


If the media contains one image only, the default value must correspond 
to the image to be restored. 

- either press the "Enter" key to select the default value 

- or give the name of another image present on the media. In this case 
the operator must give the right file name. If he types the wrong file 
name, it may take the system 30 minutes to search through the whole of 
the tape (or cartridge) before declaring that the file cannot be found. 

SIP reads the beginning of this image and checks it. 

INIT22 MTO1 MOUNTED MEDIA: SAVIT FILE: FSA43 SEQ: 0001 


This message gives the characteristics of the image (or the first part of the 
image). The SEQ (sequence number) indicates that this media contains 
the beginning of the image. 

If the SAVE image is stored on several media, up to 6 cartridge handlers 
can be used at the same time to read the image. The operator mounts the 
other corresponding media and gives the corresponding drives to SIP. 


* INIT24 UTIL DEFINE MORE INPUT DEVICE (MTXX ..) 
?R2MTO2 MTO5 


SIP checks these media. 


INIT22 MTO2 MOUNTED MEDIA: SAVT3 FILE: FSA43 SEQ: 0003 
INIT22 MTO5 MOUNTED MEDIA: SAVT2 FILE: FSA43 SEQ: 0002 


Press "Enter" to restore from a single device. (Even if there are several 
backup media, it is not compulsory to specify several devices. When the 
system requires the other next media, a message is sent requesting the 
operator to mount it.) 
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g. 


SIP Functions 


SIP checks the media to be restored, according to the information stored 
in the first SAVE media. This media can be standard, for example: 


INIT23 MS42 MOUNTED MEDIA: FSA516 


or not standard, for example: 
INIT81 MS42 MOUNTED MEDIA NOT STANDARD 


This message means that the disk does not have a volume label, but it is 
correctly formatted. 
* INITO6 <extid> IS A MIRROR DISK 

FORCE DISK RESTORE. REPLY (Y,N) 


This means that the target disk selected for a restore operation is a 
mirrored disk. 


The reply Y will force the restore to take place on one of the two mirrored 
disks. In this case, the output disk is no longer considered to be a 
mirrored disk. 


Answer N if you wish to change your target disk. 
For FSA disks: 


- if the formatting does not correspond to the SAVE image 
- or if only the default partition is defined on the disk 


another message is issued: 
INIT36 MS42 FORMAT MANDATORY 


SIP is able to format the disk. This operation is unnecessary unless the 
message INIT36 has been displayed (disks should normally be formatted 
in the factory). 

* INIT25 MS42 DISK FORMATTING. REPLY (Y,N) 


?R2N 


Disk formatting takes approximately 15 minutes. 
Final confirmation is requested. 


* INIT26 UTIL FUNCTION : RESTORE : DO YOU AGREE? REPLY (Y,N) 


eRe 


Answer N if you want to change the value of any parameters. 
When this message is displayed, no write operation has been performed 
on the disk. 


B-5 


GCOS 7 System Installation Configuration and Updating Guide 


B.5.2 
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2. Ifthe operator accepts the RESTORE, all data on the disk will be destroyed. 


a. 


SIP informs the operator of the restored files: 


INIT27 MS42 FILE INST.FW.BINLIB RESTORED 
INIT27 MS42 FILE SITE.APL RESTORED 


When the disk is fully restored, SIP displays the new name of the restored 
disk: 

INIT23 MS42 MOUNTED MEDIA: FSA43 

INIT29 UTIL RESTORE FUNCTION COMPLETED 


Otherwise, if the SAVE image is stored on several media, SIP informs the 
operator when the first SAVE media has been restored. 


INIT MTO1 TAPE: SAVT SEQ: 0001 RESTORED 


SIP searches for the following SAVE media in the defined drives and 
continues. If the following media is not found, it requested by SIP, as 
follows: 
* INIT44 GTDV DEFINE NEXT INPUT TAPE DEVICE. 

REPLY (UD <DEVICE>,CR) 
?R?2UD MTO1 


3. When the RESTORE is finished, the message INIT20 is issued again. 


The SAVE Function 


1. Before executing the SAVE function, SIP requests all the necessary 
parameters. 


a. 


SIP checks the media to be saved. Only FSA disks can be saved under 
SIP. 


INIT23 MS42 MOUNTED MEDIA: FSA43 


SIP requests the device on which the media to contain the SAVE file is 
mounted, (or the first part of the SAVE file, if it is too big for one media): 
* INIT44 GTDV DEFINE FIRST OUTPUT TAPE DEVICE. 

REPLY (UD <DEVICE>,CR) 
?R?UD MTO1 


The device can be any tape, cassette, or cartridge that is currently 
supported. 

This device must be declared in the IRT and must be available. SIP 
checks the mounted media. A message specifies its media name. 
INIT23 MTO1 MOUNTED MEDIA: TEST 

or 
INIT81 MT01 MOUNTED MEDIA NOT STANDARD 


47 A2 23US 


g. 


SIP Functions 


At the beginning of the save, SIP will prepare the media with the new 
characteristics specified in the parameters. 


If the tape drive supports several densities, the operator can specify it. 


* INIT44 MT01 DEFINE TAPE DENSITY. 
REPLY (1600,6250) 
?R? 6250 


A new volume name is requested for this mounted media: 


* INIT41 MTO1 DEFINE NEW VOLUME NAME (1-6 CHAR) 
?R? SAV 


This name is composed of 6 characters maximum. The first character 
must be alphanumeric. 

If the file to be saved is too big for one media, the operator can specify up 
to 6 other devices to mount corresponding media. 


* INIT24 UTIL DEFINE MORE OUTPUT DEVICE (MTXX ..) 
?R?2MTO2 MTO5 


SIP checks these media: 
INIT23 MTO2 MOUNTED MEDIA: WORK 


INIT81 MT05 MOUNTED MEDIA NOT STANDARD 


For every media, a new volume name is requested (message INIT41). 


Press "Enter" to save on a single device. (Even if there is not enough 
space on the first media to save the disk, it is not compulsory to specify 
several devices. When the system requires the next media, a message is 
sent, requesting the operator to mount it). 


The name of the Save file is requested. 


* INIT21 MTO1 DEFINE SAVE FILE NAME. (1 - 17 CHAR) 
PR? 


This name is composed of 17 characters maximum. The first character 
must be alphanumeric. 


Final confirmation is requested. 


* INIT26 UTIL FUNCTION : RESTORE : DO YOU AGREE? REPLY (Y,N) 


eR? 


Answer N if you want to change the value of any of the parameters. 
When this message is displayed, no write operation has been performed 
on the tape (or cartridge). 
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2. Ifthe operator accepts the SAVE, all data on the mounted tapes (or cartridges) 
will be destroyed. 


a. 


INIT 


INIT 


SIP checks the first output media again and prepares it with the 
parameters specified in the first phase (volume name, file name, density if 
necessary). 

The format is compatible with GCOS 7. The date stored in control blocks 
corresponds to the disk volume preparation date, the time to "00h 00m 
00s ", and OS identification to SIP575:00. 

SIP scans the disk to be saved and displays all the disk file characteristics. 
This information may be helpful for a specialist if a problem occurs, or if 
the operator wants to restore disk files from the SAVE file under GCOS 7. 


11 MS42 FILE : TEST1.FILE.SL 


NB_EXTENT: 0001 FB_SIZE: 001000 
2 MS42 EXTENT: 0001 DESC: 01000000 O005DB80 00000000 


00000184 480001B3 2700 


These messages describe the mapping of the found files stored on the 
disk. For example: 

The ESSAII.FILE.SL file is composed of one EXTENT 

Its file block size is "1000" hexa 

Extent description: 01 extent type (data records) 


000000 number from the file beginning of the first FILE BLOCK 
in this extent 


0005DB number from the file beginning of the last FILE BLOCK 
in this extent 


80 extent flags 
00000000 RFU 
00 Partition number 


00018448 data block number of the first data block which is 
included in the first file block in this extent 


0001B327 data block number of the last data block that is included 
in the last file block in this extent. 


00 RFU 


SIP saves all disk files. 
SIP informs the operator of the saved files (except for the VTOC files): 
INIT27 MS42 FILE INST.FW.BINLIB SAVED 


INIT27 MS42 FILE SITE.APL SAVED 


when the tape (or cartridge) is full or when the disk is fully saved: 
INIT48 MTO1 TAPE SAVT1 FULL 
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e. when the disk is fully saved: 

INIT23 MS42 VOLUME FSA42 HAS BEEN SAVED ONTO FILE 
SAVFSA42 
INIT29 UTIL SAVE FUNCTION COMPLETED 


f. Otherwise SIP searches for another tape (or cartridge) in the defined 
drives, checks it (message INIT23), prepares it and continues saving the 
disk. 

If no other tape (or cartridge) is found, it requests it: 


* INIT44 GTDV DEFINE NEXT INPUT TAPE DEVICE. 
REPLY (UD <DEVICE>, CR) 
?R?UD MTO1 


3. When the SAVE operation is over, the message INIT20 is issued again. 


B.6 UTIL Error Messages 


NOTE: 
Where the meaning of each message is described: 


S = Applies to the SAVE function. 
R =Applies to the RESTORE function. 
B =Applies to both SAVE and RESTORE. 


INIT18 <extid> FILE : <file name> : TOO MANY EXTENTS 


meaning: (S) During the disk <extid> scan, if it is discovered 


SIP Functions 


that a file has too many extents or is badly described in 


the disk VTOC, then it is not possible to save the disk 
under SIP. 


action: Try again with another disk in the installation. 


INIT19 <extid> FILE : <file name> : ILLEGAL DESCRIPTION IN VTOC 


meaning: (S) During the disk <extid> scan, if it is discovered 
that a file is badly described in the disk VTOC, then it 
is not possible to save the disk under SIP. 


action: Try again with another disk in the installation. 
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INIT30 UTIL 


meaning: 


action: 


INIT31 UTII 
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meaning: 


action: 


INIT32 <extid> 


FILE: 


<util function> FUNCTION ABORTED 


(B) After messages INIT35, INIT18, INIT19 the <util 
function> is aborted by the system. 


Try again with another SAVE image or another target 
media. 


<util function> FUNCTION CANCELLED BY OPERATOR 


(B) After answering CR at the requests INIT44, 
INIT69, or N to the requests INIT26, INIT39 the <util 
function> is aborted. 


Try again with another SAVE image or another device. 


<file name> SEQ <tape number> MISSING 


meaning: 


action: 


INIT33 <extid> 


meaning: 


action: 


INIT34 <extid> 


FILE: 


(R) The media mounted on the device <extid> defined 
at the request INIT24 are not in sequence. 


Mount the media in sequence. 


<file name> SEQ <tape number> EXPECTED 


(R) An INPUT media containing the <file name> and 
the SEQ <tape number> is expected. 


At the request INIT44 , mount the expected INPUT 
media. 


ALREADY ALLOCATED 


meaning: 


action: 


(B) The INPUT device <extid> defined at the request 
INIT24 is already allocated as the first INPUT device. 


Define another INPUT device at the request INIT24. 
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INIT36 <extid> FORMAT MANDATORY 
meaning: (R) This message is issued: 


— if the disk <extid> format does not correspond to the 
SAVE image. 

— if only the default partition is defined on the target 
disk <extid>. 


action: Answer Y after the INIT25 request that follows, or try 
again on another target disk. 


INIT37 <extid> NOT ENOUGH SPACE FOR RESTORE FUNCTION 


meaning: (R) The target disk <extid> is too small to restore the 
SAVE image. 

action: Define another OUTPUT MASS STORAGE device at 
the INIT44 request that follows, or change the SAVE 
image. 


* INIT39 <extid> RETRY IO AT CHECK POINT? REPLY (Y,N) 


meaning: (R) After the I/O error message INIT65 on the device 
<extid>, and if a retry is possible, this message is 
issued. 

action: According to the error, the operator can clean the 


reading driver, or set the device <extid> to the Ready 
state, and answer Y for a retry. If he answers N, or if 
the retry is not effective, the RESTORE function will 
abort. 


INIT40 <extid> FILE <file name> NOT COMPLETELY RESTORED 


meaning: (R) If a BLOCK F% is detected on the SAVE image 
<file name> (BLOCK indicating that an I/O error 
occurred during the disk save under GCOS 7), SIP 
stops restoring. 


action: After a disk save under GCOS 7, check that no I/O 
error occurred during the save operation, if the SAVE 
image is to be restored under SIP. Regenerate a correct 
SAVE disk image. 
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INIT43 <extid> 


DEFINED DENSITY NOT SUPPORTED BY THIS DEVICE 


meaning: 


action: 


INIT45 <extid> 


(S) This message is issued after the INIT24 request, if 
the given device <extid> does not support the density 
chosen during the definition of the first output device. 


Mount the media on a device which supports the 
expected density defined in the INIT24 request. 


MEDIA EXPECTED : <vsn> 


meaning: 


action: 


INIT50 <extid> 


(S) The media mounted on the device <extid> was 
changed after the definition of its parameters and 
before its use by SIP. 


After the INIT44 request that follows, mount the 
expected media <vsn>, or cancel the request. 


ILLEGAL MASS STORAGE MODEL 


meaning: 


action: 


INIT51 HDLR 


meaning: 


action: 


B-12 


(B) The mass storage device <extid> is not supported 
by the UTIL function. Only FSA disks are supported 
for the SAVE and RESTORE functions. 


Define another device or check the IRT (Installation 
Resource Table). 


FATAL ERROR <alpha-8> : IC= <instruction counter> 


(B) This message is issued when SIP aborts at the 
<instruction counter>. <alpha-6> explains the SIP 
exceptions: 


ABSCCE Absolutize the CCE error. It is 
probably an error in SIP itself. 

BADCALL Wrong procedure call. It is 
probably an error in SIP itself. 

LSYSFAIL The INIT54 request to define the 
ISL device has been cancelled. 

MMOVFLW Main memory overflow (no more 
space for SIP internal buffer 
allocation). It is probably an 
error in SIP itself. 


For the errors ABSCCE, BADCALL, MMOVFLW 
call a Bull specialist. 


For LSYSFAIL error, re-initialize the system with the 
right ISL device. 
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INIT55 <extid> 


SIP Functions 


ILLEGAL DEVICE TYPE. ONLY <extyp>/<extyp> ALLOWED 


meaning: 


action: 


INIT56 <extid> 


meaning: 


action: 


INIT63 <extid> 


(B) This message is displayed after the requests 
INIT20, INIT24 or INIT44, if the device type of 
<extid> does not correspond to the expected device 
type <extyp>. 


At the next request, define a device with an expected 
device type. 
UNKNOWN RESOURCE 


(B) This message is displayed after the requests 
INIT20, INIT24 or INIT44, if the device <extid> is not 
described in the IRT. 


At the next request, define a device that is described in 
the IRT. 


MEDIA IN WRITE PROTECT 


meaning: 


action: 


INIT65 


meaning: 


action: 
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<extid> IO ERROR : 
EV= <event type> 
to dsb3> <dsb4 to dsb7> ... ] 


(B) The OUTPUT media mounted on the device 
<extid> is in write protect mode. This message is 
followed by the request INIT44. 


Set the media in write permit mode and mount it again. 


CCE= <word1><word2> 
[DSB= <dsb0 


PCLC= <pclc> 
PSB= <psb0 to psb3> 


(B) This message is issued after an access to the device 
<extid>: 


a. when the operator cancels the request INIT89 
b. ifan I/O ERROR occurs during a device access 


For both a) and b) an J/O error message with device 
Detailed Status Byte (if available) is displayed and 
retried, or new devices are requested (INIT44, 
INITS54). 


Call the Bull Customer Service. 


GCOS 7 System Installation Configuration and Updating Guide 


B-14 


INIT66 <extid> IO ERROR : PCLC= <pclc> CCE= <word1><word2> 
CP DISCONNECTED : ELAPSE TIME= <timer value> 


meaning: (B) After a Channel Program connection by the <pcle> 
path, the device <extid> has not sent any termination 
message although the <timer value> has elapsed. The 
CP is disconnected by SIP. 


action: Check the device state. Call the Bull Customer 
Service. 


INIT67 <extid> CONNECT ERROR : PCLC= <pclc> CCE= <word1><word2> 
PHYSICAL CHANNEL NOT OPERATIONAL/LC ENQUEUED 
OR ACTIVE/TERMINATION NOTIFICATION PENDING 


meaning: (B) SIP accesses a device <extid> that has one of the 
following characteristics: 


a. connected to a failed controller 

b. connected to a controller which belongs to a 
non-initialized IOC 

c. after the message INIT66, the CP disconnection 
has failed 


The request INIT44, or INIT54, is issued in order to 
retry on another device if possible. 


action: Check the IOC or controller state and perform INIT 
again if the retry on another device is not possible. 


* INIT69 <extid> RECOVER.REPLY (UD,CR) 


meaning: (B) If the <extid> peripheral (tape, disk, printer) is not 
ready, SIP loops on this message. 


action: Put the device in the READY state and reply UD. If 
this is not possible, the answer CR sends the device 
state with the INIT65 message. 


INIT74 <extid> DEVICE RESERVED 


meaning: (B) The device <extid> is seized by another system. 
An INIT24, INIT44, or INITS4 request follows this 
message. 

action: Define another device at the next request, or release 


this device on the other system (with the command 
HDV under GCOS 7) and use the device again. 
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INIT80 <extid> 


meaning: 


action: 


SIP Functions 


IMPORTANT : VOLUME IN AN UNSTABLE STATE 


(B) This message is issued when SIP opens a file on 
the disk <extid> and it detects that the media is in an 
unstable state. 


— Either an unstable bit is present in the volume label 
because the disk has not been completely restored 
after a RESTORE operation under SIP or GCOS 7 

— Or, for FSA disks, the disk characteristics do not 
correspond to the logical characteristics stored in the 
VTOC). 


SIP will continue to work with this disk but 
unpredictable results may occur when it is used. 


Under GCOS 7, check the disk and rebuild it by using 
the SAVE_FILE and RESTORE FILE utilities. 


INIT86 UTIL INVALID RESPONSE 


meaning: 


action: 


(B) This message is issued after any SIP request if the 
answer given is invalid. 


Call the Bull Customer Service. 


INIT91 <extid> MEDIA <usn> : ILLEGAL FILE SAVE 


meaning: 


action: 
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(R) The SAVE file accessed by SIP on the media 
<usn> has an illegal format. 


Define an input media containing a SAVE image 
standard to the VOLSAVE FILE FORMAT for a 
GCOS 7 FBO release (this image must be generated 
using SAVE _DISK under GCOS 7 or SAVE under 
SIP). 
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INIT97 <extid> 


meaning: 


action: 


INIT98 <extid> 


meaning: 


action: 


GCOS INVALID VERSION: <version> VERSION EXPECTED 


FILE 


If <version> = V8.1: if system S1 is initialized for the 
Millennium environment Test, the GCOS 7 version 
must be at least V8 TS 8560. 


If <version> = V9.1: for DPS 7000/TAxxx/TxxxC, the 
GCOS 7 version must be at least V9 TS 9662. 


In MANU mode: this message is followed by the 
INIT54 request. 


In AUTO mode: SIP aborts with the INITS51 message 
(LSYSFAIL). 


At INIT54 request: 


If <version> = V8.1: define a new ISL device with 
GCOS 7 version, which supports Millennium 
environment Test. 


If no V8.1 GCOS 7 version is available: 
1. Cancel the INIT54 request and 


2. Restore anew GCOS 7 version 8.1 from the 
system SO. 


If <version> = V9.1: define a new ISL device with 
GCOS 7 version, which supports TAxxx/TAxxxC 
(model 86xx). 


If no V9.1 GCOS 7 version is available: 
1. Cancel the INIT54 request and 


2. Restore anew GCOS 7 version 9.1 with 
SIP/UTIL or contact the Bull Customer 
Service. 


: <file name> IS LOGICALLY UNSTABLE 


(S) During the disk <extid> scan, SIP warns the 
operator if a file was badly closed at the previous 
GCOS 7 session. The SAVE function is not aborted, 
but unpredictable results may occur when the SAVE 
file is used again. 


Keep this information, which may be helpful when you 
next use the SAVE file. 
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INIT99 <extid> 


meaning: 


action: 


FILE 


= 


ry 


: <file name> IS MULTI VOLUME 


SIP Functions 


(S) During the disk <extid> scan, SIP warns the 
operator if a file was stored on several media. Only 
the data stored on the saved disk will be stored in the 
SAVE file. The SAVE function is not aborted, but 
unpredictable results may occur when the SAVE file is 
used again. 


Keep this information, which may be helpful when you 
next use the SAVE file. 
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C. Disk VOLPREP Procedure 


C.1 Introduction 


This Appendix is intended as an aid to installation for new users. It describes the 
procedure for preparing volumes to be used in the installation procedure, as well as 
providing an example of the correct technique to be followed. A complete 
description of the VOLPREP utility (the GCL procedure is PREPARE DISK) may 
be found in the Data Management Utilities User Guide. 


Three types of VOLPREP may be identified: 


1. 
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A complete VOLPREP, with surface formatting. This type of VOLPREP 
automatically assigns defective blocks, and takes at least 10 minutes of 
elapsed time, possibly more, depending on disk capacity and machine load. 


A quick VOLPREP that bypasses surface formatting, but which specifies the 
BADBLOCK parameter. This type is used to reassign additional bad blocks. 
The new reassigned blocks are only those that have been defined explicitly in 
the BADBLOCK parameter of the VOLPREP statement. All previously-set 
defective blocks are preserved as such. This type of VOLPREP typically 
executes in a few seconds. 


A quick VOLPREP which bypasses surface checking and does not specify the 
BADBLOCK parameter. This is used to deallocate all the existing files on a 
disk, or to change the MEDIA name of the disk. All previously-set defective 
blocks are preserved as such. This type of VOLPREP is used typically at the 
beginning of a restartable disk-loading job, to eliminate any files created by a 
previous, and perhaps aborted, execution of the job. 
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C.2 VOLPREP Activation 


If the volume does not already have a GCOS 7 label, the following message is 
displayed when the disk is READY: 


MSxx NON STANDARD VOLUME 
In this case, the operator should reply: 
NV MSxx md 


where xx is the drive number, as given in the NON STANDARD VOLUME 
message, and md is the MEDIA name to be given to the disk (of up to 6 
alphanumeric characters in length). 


The following message is then sent: 
MSxx md PREMOUNTED NSTD 
If, on the other hand, the volume already has a GCOS 7 label, the message is: 


MSxx md PREMOUNTED 
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D. Maintenance in a Protected Environment 


D.1 Introduction 


The GCOS 7 Operating System allows the protection of objects (i.e., files, 
directories and volumes) through the Access Rights Facility. Details of this facility 
are given in the Data Security User's Guide. 


Use of this facility, for objects involved in GCOS 7 software maintenance, requires 
advance planning and an understanding of all the implications. This Appendix 
describes the necessary considerations and, where appropriate, offers 
recommendations. 
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D.2 


D.2.1 


D.2.2 


D-2 


Cataloging System Files 


All GCOS 7 system files are cataloged, with the exception of SYS.IN and 
SYS.OUT. Cataloged system files may be divided into two groups. 


SYS.CATALOG Files (Group 1) 


The files cataloged in SYS.CATALOG are all GCOS 7 system files prefixed by 
SYS. The contents of SYS.CATALOG are handled by the maintenance functions. 


All these files are cataloged at installation time, and must never be uncataloged by 
the user. 


The user may set access rights on these files, using the GIUF function 
PROTECT_GCOS. Execution of this function requires that the owner of the 
SITE.CATALOG be the project SYSADMIN. 


The system and site files are supplied with certain minimum access rights, as 
shown in Table A-5 at the end of Appendix A. These minimum access rights may 
be added to, or increased, by SYSADMIN. They may not be reduced or cancelled 
by the user. 


SITE.CATALOG Files (Group 2) 


The system site files cataloged in the SITE.CATALOG are: 


SITE.HELP 

SITE.IN 

SITE.STARTUP 

SITE.CATALOG itself 

and, if they exist, SITE.SHALOCK, SITE.CMS *, and SITE.MIRLOG. 


Some other system files can be cataloged in SITE.CATALOG but are not managed 
under GIUF. Instead, they are managed directly by system commands 
(SITE.QUOTA for example). 


SITE.CATALOG is handled by dedicated maintenance functions; however, the user 
has control over the cataloging of SITE.HELP, SITE.IN and SITE.STARTUP. It is 
also the user's responsibility to maintain this catalog information whenever 
necessary. The user may wish to locate the SITE.CATALOG on a volume not 
handled by TAILOR. In any case, it is the user's responsibility to set access rights 
on all these files. 
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Maintenance in a Protected Environment 


D.3 Manipulating the SITE.CATALOG 


After creating a new P-Set/P2-Set, the user must transfer the contents of the 
SITE.CATALOG file (from the site of the old P-Set/P2-Set) using the 
COPY_SITEFILES function (described in the chapter /nstallation and Updating 
Facility). If the original SITE.CATALOG file was protected, the transferred file 
will also be protected. 


The other maintenance utilities, which manipulate already-built Sets, will abort 
with the return code "ARVIOL" (i.e., Access Rights VIOLation) if any attempt is 
made to move the SITE.CATALOG's contents from a protected Set to an 
unprotected Set. In this case, the user must either set access rights on the 
unprotected Set, or remove them from the protected one. 
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D.4 The SYSADMIN Project 


The user is recommended to protect the system with the GIUF function 
PROTECT_GCOS. Adding the OWNER attribute to SYSADMIN may protect the 
volumes that contain GCOS 7 system files. If this is done, operations at file and 
volume level (for example, automatic allocation of space for a temporary file) can 
be performed by the SYSADMIN project only. 


Most maintenance jobs include file or volume level operations and, if the files are 
protected, these jobs can be executed by SYSADMIN only. The maintenance jobs 
are divided into two groups: 


Group 1: Jobs including functions that are always restricted to 
SYSADMIN (BUILDP, UPDATE GCOS, 
LEVEL, ...). 

Group 2: Jobs that are run under projects other than 


SYSADMIN (certain management jobs). 


The projects under which these jobs may execute are controlled by the project 
under which the user submits the GIUF function. The Group | functions always 
restricted to SYSADMIN are: 


BUILDP 
BUILDP2 
PROTECT_GCOS 
UPDATE_GCOS 
LEVEL 


These functions are rejected whenever submission is attempted under any project 
other than SYSADMIN. 


At delivery time, two users are recorded under the project SYSADMIN: 
- GCOS7 
- SYSADMIN. 


Whenever required, the user may modify the user names attached to the project 
SYSADMIN. 


Project identity is not checked when submitting a function belonging to Group 2. 


For this reason, it is recommended that they be submitted under the project 
SYSADMIN nevertheless, whenever access rights are validated on the site. 
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Glossary 


Basic System 
The initialization firmware and software, generated under GCOS 7 and personalized according to 
the hardware configuration of the site. 


The Basic System files are: 


SYS.FW.MSP (not available for XTA systems) 
SYS.FW.WSP (not available for XTA systems) 
SYS.HUB (not available for XTA systems) 
SYS.HUB7 (not available for XTA systems) 


SYS.HUBG 
NOTE: 
SYS.HUB7 is loaded by the BSR P2 and mandatory for the 
DPS 7000/TAxxx/TAxxxC, and DPS 7000/MTx2 and up. 
BSR 


The Basic System Release, which contains the source components of Firmware. The Firmware 
system files, the names of all of which begin with SYS.FW.* , are detailed in Appendix A. 
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Cc 


CCE 
Channel Command Entry. This is a basic element of a channel program, that describes either 
positioning or transfer commands for the controller. 


CDA 7 
Cache Disk Array for DPS 7000 systems. 


CKD 
Count Key Data type disk. 


CP 
Channel Program. This is a set of headers and CCEs. The I/O complex (represented by a 
PIOBLOCK) handles the logical CP, the physical CP is connected to the hardware. 


D 


Disk Set 
A set of disks required to run GCOS 7. The disks within any single set are interdependent and so 
do not require any other disk in order to run in an operational environment. 


No system file may be duplicated within any single set. 
See P-Set, P2-Set, R-Set. 


Distribution Center 
The office from which the user receives the G-MEDIA, K-MEDIA, STARTER-MEDIA, 
DOMAINS-MEDIA, P-MEDIA, SET-MEDIA, FW-MEDIA, EC-MEDIA, and INSTAL-MEDIA 
(for stand-alone Domains media). 


Domain 
A Domain contains the files required by a given part of the system. This concept is used by most 
IUF functions. 


The user's system may have up to five Domains for system files: GCOS, DSA, OLTD, GSF and 
FIRMWARE. 


DOMAINS-MEDIA 
A set of media containing the three Domains: OLTD, DSA, and GSF. 
E 


EC-Media 
Contains emergency corrections and is used by the patching procedure relevant to the system file 
Domain concerned. 
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F 


FBO (Fixed Block Organization) 
GCOS 7 file architecture characterized by fixed-length file blocks occupying the whole file space. 
Applied to volumes, FBO indicates the GCOS 7 disk volume format where an entire volume's 
space is formatted with fixed-length data blocks. This organization is applicable to all DPS 7000 
systems. 


FSA 
Fixed Sector Architecture, the only type of disk format supported for system files. 


FW-MEDIA 
Contains the Firmware files belonging to the FIRMWARE Domain and is provided for backup 
purposes for new users. 


G 
G-Media 
The media containing the delivered GCOS 7 system, and is a set of tapes or cartridges for use by 
the Installation and Updating procedures. The G-MEDIA is not a disk-image and so cannot be 
restored using the SIP function RESTORE in UTIL mode (which is described in Appendix D). 
GCOS 7 
In the context of IUF, GCOS 7 is considered in a larger sense than usual; that is, as including 
products not strictly belonging to it. These products are: 
e The Distributed Network Supervisor (DNS) running on the Datanet. 
e The Distributed Network Supervisor-Extended (DNS-E) running on the MainWay. 
e The FDDI Communications Processor 7 (FCP7), which allows a DPS 7000 to connect to a LAN 
Extender 7, or to a MainWay communications processor. 
e The CNS7 supervisor running the CNP7(s). 
e The On-Line Tests and Diagnostics (OLTD). 
e The Firmware Generation files (FW). 
e The GCOS 7 Service Facility (GSF). 
GSF 


GCOS 7 Service Facilities deal with the Installation and Updating procedures for the GSF system 
file Domain required to support the mandatory GSF service tools used for the maintenance of 
GCOS 7. 
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H 


Hub Files 
See Basic System. 


IOC 
Input Output Controller 


IRT 
Installation Resource Table 


ISL hitial system Load) 
At ISL time, the logical and physical I/O paths are validated for each device defined in the 
hardware configuration, as described in the SRST (System Resource Table). The devices and 
controllers are initialized, and the software tables are updated accordingly. 
ISL is executed at each system restart, prior to GCOS 7. 


K 


K-Media 
The K-Media is the media containing the unbundling key, which causes GIUF processor to validate 
the GCOS 7 software products ordered by the client. If this K-Media is a piece of paper, the key is 
entered at the console (only for the IUF functions ADD_MI and DELETE_MI, when the 
KEY_ CODE parameter is used). 


The unbundling key is used by the VALIDR, VALIDP, VALIDP2, ADD MI, DELETE MI and 
UPDATE _MI functions, and is client- and site-dependent. 


The K-MEDIA is defined as: 


MD=MIKEY DVC=dvc EFN=MIKEY 


L 


LSS (Large Storage Sub-system) 
Large capacity FSA disk of 1.4 or 2.5 giga bytes. 
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M 


Master Set 
Specifies a disk set (a P-Set, a P2-Set, or an R-Set) belonging to the master system; see 
Multi-system, below. 


MI Configuration Code (MI CONF.CODE) 
This code identifies an MI (Marketing Identifier) software configuration, and is created when the 
MIs are validated on an x-Set disk at Installation time. It consists of the time and date of the MI 
validation. 


Module Correction 
Module corrections are unique to the provision of a new Technical Status. They replace entire 
modules, and are applied via the Updating procedure. 


Multi-System 
Environment in which a user may install and maintain disk Sets belonging to several DPS 7000 
systems. 


One of these systems is defined as being the MASTER system and all others are considered as 
being SLAVE systems. 


p 

P-MEDIA 
This is a VOLSAVE of the factory-prepared P-Disk. 
A set of tapes or cartridges supplied with a new DPS 7000 that does not have a pre-loaded disk and 
containing a factory-prepared image of the P-Set. This image is obtained by running the 
VOLSAVE utility or the GCL procedure SAVE_DISK. 
The P-MEDIA is used on the customer site to create the P-Set. 

P-Set 
See Production Set. 

P2-Set 


See Production Set and P2P-Configuration. 


P2P-Configuration 
A configuration which consists of one P-Set and one P2-Set. Each Set is used alternately (in 
"flip-flop" mode) to run GCOS 7. The system alternates from one Set to the other after application 
of a Technical Status to the non-running Set. 
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PCLC 
Physical Channel Logical Channel. 


PO-Configuration 
A configuration that consists of only one P-Set. There is no R-Set disk in such a configuration, 
which makes this the least expensive type of configuration, but also the least secure. 


Production Set 
A Production Set consists of one or more disks containing all the system files necessary to operate 
GCOS 7. A site may have more than one Production Set. 


R 


R-Set 
See Reference Set. 


R-Set On Line 
The R-Set is said to be on line when its disk space remains allocated on a fixed disk of device class 
MS/FSA. 


R-Set Off Line 
The R-Set is said to be off line on a fixed disk configuration when its disk space is allocated to the 
user. Its image is saved on tape or cartridge and restored when necessary. 


Reference Set 
A disk Set containing the GCOS Domain files and other Domain files necessary for IUF operation. 
This Set is used to create a first or additional P-Set by using the BUILDP function. The R-Set is 
monodisk. 


RP Configuration 
A configuration which consists of one R-Set and one or several P-Set(s). Only the P-Set may be 
used to run GCOS 7 and Technical Statuses are applied to this Set. The R-Set is available as a 
backup in the event of the P-Set being damaged. 


S 


SDA7 
Small Disk Array for DPS 7000 systems. 


Set-MEDIA 
A save of the system files (belonging to all the Domains applicable) on tape or cartridge. The save 
is performed by the IUF function SAVE SET. The contents of the tape (or cartridge) may only be 
restored by the IUF function RESTORE_SET (or by the job INSTAL_RSET). 


Ship Media 
This is a component delivered with the system and used to perform the first initializations until the 
Firmware HUB (Basic System) files have been generated. 
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Slave Set 
Specifies a P-Set, P2-Set, or R-Set belonging to a slave system. See Multi-system. 


SOP 
Service Operator Panel. 


SRST 
System Resource Software Tables. 


Starter-MEDIA 
Part of the material supplied to the user by the Local Distribution Center. The media contain a disk 
image belonging to the same family as the first work disk to which it is to be restored. 


System Disk 
An FSA disk containing loaded files which enable the user to start GCOS 7 and obtain the 
SYSTEM READY message. The set of system disks constitutes the Production Set. 


T 


TA (Twin Architecture) 
Architecture of the DPS 7000/TAxxx/TAxxxC platform based on GCOS 7 and OPEN processors. 


Technical Level 
The Technical Level of a Set is determined by the Technical Status applied to it. (See definition of 
Technical Status.) 


Technical Status (TS) 
ATS consists of module corrections, and may be applied to any P-Set or P2-Set to be used as input 
to the Updating procedure. 


The number of the Technical Status of the GCOS, OLTD, FW, and GSF domains, is displayed after 
the DISPLAY STATUS command of GIUF. 


TS-MEDIA 
The TS-MEDIA contains a Technical Status of a given Domain (GCOS, FW, OLTD, DSA or GSF) 
to be used by the Domain Updating procedures. For the GCOS Domain, the TS-MEDIA is the 
same as the G-MEDIA. 
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V 


VBO (Variable Block Organization) 
The GCOS 7 file architecture characterized by variable-length file blocks occupying the file space. 
Some file organizations also contain blocks holding physical keys. Applied to volumes, indicates 
the GCOS 7 disk volume format where a volume's space contains variable-length data blocks 
and/or keyed physical records. 
Only dedicated for data user. 


W 


WORK DISK 
IUF uses work disks that have been preformatted, with replacement tracks already allocated. The 
advantage is that [UF can clear the disk with the GCL procedure PREPARE _ DISK or the JCL 
utility VOLPREP. However, the user is unable to change the disk's name. 


A work disk may be temporary or may become a permanent disk belonging to a Set. 


X 


XTA (eXtended Twin Architecture) 
Architecture of the DPS7000/XTAxxx platform based on GCOS 7. 
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